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Welcome 


WELCOME 


hen we introduced our last Official 
Projects book we were excited that 
seven million Raspberry Pis had 

been sold. Since then, the Raspberry Pi has 
achieved two further milestones: it’s reached 
ten million sales and has become the best- 
selling British computer of all time. By our 
calculations that’s quite a few new people in 
the Raspberry Pi community! 

If you’re one of those new people, then we 
heartily welcome you to the latest Raspberry 
Pi Official Projects Book. With 200 pages 
of excellent guides, inspiring projects, and 
informative reviews, it should keep you busy 
learning about all the amazing things you 
can do with your Raspberry Pi. We even have 
a Getting Started guide if you’re trying to 
figure out where to begin. For Pi veterans, 
there are some truly challenging builds to 
eet stuck into as well. 

I hope you all enjoy this book! 

Rob Zwetsloot 


Coam Meee Magpi@raspberrypi.org 


PUBLISHING 


For advertising & licensing: 
russell@raspberrypi.org 
Publisher. Liz Upton 

CEO: Eben Upton 


CONTRIBUTORS 


Wesley Archer, Dana Flinn, Tony Goodhew, Brett 
Haines, Gareth Halfacree, Lucy Hattersley, Richard 
Hayler & Sons, Phil King, James Singleton, Richard 
Smedley, & many more Pi-loving people! 


This official product is published by Raspberry Pi (Trading) Ltd., Station Road, Cambridge, CB1 2JH. The publisher, editor and 
contributors accept no responsibility in respect of any omissions or errors relating to goods, products or services referred 
to or advertised in the magazine. Except where otherwise noted, content in this magazine is licensed under a Creative 
Commons Attribution-NonCommercial-ShareAlike 3.0 Unported (CC BY-NC-SA 3.0). ISBN: 978-1-908256-93-5. 
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NEW YEAR NEW YOU 
Get on your resolutions with these Pi- 
powered New Years projects 


PIP-BOY 3000A 
Fallout's wrist computer, now available in 
the real world 


) EYE-CONTROLLED WHEELCHAIR 
Hacking a wheelchair with 3D-printed parts 
and windscreen wiper motos 


SPACEHACK PI 
A game simulating a disaster aboard the 
Starship Guppy 


FABSCAN Pl 
An open source, DIY 3D scanner made tiny 
with the help of Raspberry Pi 


36 ULTRASONIC THERAMIN 


Creating spooky 50s sci-fi effects with a 
range sensor and your hand 


} SPARK CLUSTER 
Six Raspberry Pis connected together to 
make a modest super computer 


RAFTBERRY 
Pootling around a lake on a motorised raft 
with some beers 


MASON JAR PRESERVE 


Preserve your memories with this Pi-in-a-jar 


SUPER GAMEGIRL 
A 3D-printed RetroPie masterpiece that 
upgrades the humble Game Boy 


MINI MACPI 
The smallest Mac you ever did see, and it 
works too 


PIANO HAT 
A musical instrument attachment for 
your Pi 


IQAUDIO PI DAC+ 
Get better audio output from the 
Raspberry Pi 


LIGHTBERRY PI 
Improve movie night with this ambient 
light kit 


SPI-BOX 
A special kit for creating a simple CCTV 
system for your home 


SENSE HAT 
The special HAT that powers the Astro 
Pi mission 


es The Official Raspberry Pi Projects Book 


CNC MACHINE 
Woodworking with a bit of Pi-powered 
CNC to boot 


02 SEEMORE 


One part sculpture, one part Supercomputer 
cluster, the SeeMore is a work of art 


> MAGIC MIRROR 


A high-tech mirror that lets you check the 
weather and much more 


3 RPI KIDS 


How one dad created a clever media 
centre for his kids 


RASPIMOWER DALEK 
Not quite exterminating the grass as 
much as giving it a nice trim 


SPY ROVER 
Upgrading an old toy into a remote- 
control spy bot 


SNIFFUR 
Tracking the office pooch with some 
bluetooth beacons 


KILIMANJARO 
A replica of the mountain that lets family 
members track a climbers ascent 


PROSTER MULTIMETER 
Check the circuits in your project with 
this multi-function tool 


ADAFRUIT GEMMA 
Wearable tech is all the rage, make 
something of your own 


BALANCEBOT 
A robot riding around on two wheels that 
can also react to people's emotions 


2 EYE Pi CAMERA 


Taking beautiful and surrealIR photos with 
a Pi Noir Camera Module 


P| DESK 
A space-age desk worthy of any starship 
or kids bedroom 


. HALLOWEEN PROJECTS 


Prepare yourselves for some spooktacular 
Raspberry Pi projects 


P| ZERO PROJECTS 
Some amazing projects that make use of 
the tiny Pi Zero 


MEDIA PI PLUS 


A special enclosure for your Raspberry Pi 
that makes it the ultimate media centre 


PIMORONI DAC HAT 
Another HAT that promises to improve 
your Raspberry Pi audio 
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Tutorials 


96 GET STARTED WITH SENSE HAT 
Use your Sense HAT to take readings and 
display messages 


98 PIXEL ART WITH SENSE HAT 
Display tiny pixel characters on your 
Sense HAT 


100 GPIO ZERO TRAFFIC HAT 
Learn some basic GPIO Zero code by 
programming traffic lights 


102 TWEET WITH WOLFRAM 
Wolfram is free on Raspberry Pi and you 
can do some cool things with it 


104 TIMELAPSE PHOTOGRAPHY 
Create stunning timelapse videos by setting 
up a special project 


106 PUSH NOTIFICATIONS WITH 
MOTIONEYE OS 
Make a smart CCTV system using a PI 
and MotionEye OS 


108 Pl GLOWBE 
Awake-light that helps you wake up 
more naturally in the morning 


110 PROGRAM CODEBUG IN PYTHON 3 
Use Python 3 to make a game on a little 
CodeBug add-on board 


112. PLAY WITH PIANO HAT 
Become the next Chopin by turning your 
Pi into a Piazo 


176 PI-TOP 
The crowdfunded Raspberry Pi laptop 
you build yourself 


178 DIGITAL SOLDERING STATION 
Improve your soldering technique with this 
advanced soldering station 
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Contents 


115 Pl PHRASE 
Make a game show on Raspberry Pi and 
remember to say what you see 


118 MAGIC PRESENTATIONS WITH 
SKYWRITER 
Use Skywriter's gesture control to give 
your talk some pizazz 


120 BUILD YOUR OWN HAT 
Can't find a HAT that does what you 
want? Make one! 


124 1OT PLANT WATERER 
Automate your plant watering in this 
handy guide 


128 PIPE TEMPERATURE MONITOR 
Keep your house safe in the winter by 
checking your pipes 


132 PI MI-LIGHT 
Control wireless-enabled light bulbs for 
true home automation 


1386 BUILD A BINARY CLOCK 
Create a beautiful and very different 
time piece 


140 GET STARTED WITH PI ZERO 
Learn the ins and out of the tiniest 
Raspberry Pi 


146 PI ZERO ACCESSORIES 
Gear up your Pi Zero with these excellent 
tiny add-ons 


148 Pl ZERO CONSOLLER 

Create an advanced portable 
retro games console with its own 
rechargeable power 


180 BARE CONDUCTIVE TOUCH BOARD 
STARTER KIT 
Create fun electronics projects with 
conductive paint and more 


182 MAGZOR STARTER KIT 
Build custom robots with your own 
specifications 


183 CAMJAM EDUKIT 3 
A tiny robot kit in honour of the Pi Wars 
competition 


152 Pl ZERO RESET SWITCH 
Add avery simple button that will reset 
your Pi Zero 


154 SLACKTIVITY MONITOR 
Want to see how many messages you've 
missed on Slack? Build this monitor 


156 PI-SABER 
Feel the force of electronics in this 
weaponised pool noodle 


158 QUAKE III INA MOUSE 
Plug in a mouse to your TV and play 
Quake Ill on it. Magic! 


160 Pl ZERO NES CONTROLLER 
Create a quick and easy retro games 
console inside a controller 
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184 UBUNTU PI FLAVOUR MAKER 
Create your own spin of Ubuntu for the 
Raspberry Pi 


186 LCD CONTROL CASE 
A special case for your Raspberry Pi that 
lets you use a tiny touch screen 


188 RASPIROBOT V3 
Use this robot motor board in your next 
Raspberry Pi robot 


189 ZEBRA ZERO 
A lovely wooden case made especially for 
a Pi Zero 


190 BOOKS 
Get the low-down on many excellent 
books that can help you make and code 
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WITH RASPBERRY P! 


he Raspberry Piisa 

J wonderful microcomputer 
os that brims with potential. 

With a Raspberry Pi you can 

build robots, learn to code, and 

create all kinds of weird and 

wonderful projects. 

Hackers and enthusiasts have 
turned Raspberry Pi boards into 
fully automated weather stations, 
internet-connected beehives, 
motorised skateboards, and 

much more. The only limit is 

your imagination. 

But first, you need to start at the 
beginning. Upon picking up your 
Raspberry Pi for the first time, 
you’re faced with a small green 
board of chips and sockets and 
may have no idea what to do with 
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Creating amazing projects is easy with a Raspberry Pi, but first 
you need to plug it in and set up Raspbian, the default operating 
system. This guide will get you up and running in no time 


it. Before you can start building 
the project of your dreams, you’ll 
need to get the basics sorted: 
keyboard, mouse, display, and 
operating system. 

Creating projects with a 
Raspberry Pi is fun once you’ve 
mastered the basics. So in this 
guide, we’re going to take you from 
newbie zero to Raspberry Pi hero. 
Grab your Raspberry Pi and let’s 
get going. 
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MICRO SD CARD 


The micro SD card acts as the 
hard drive for your Raspberry Pi. 
You install the Raspbian operating 
system onto the card, then all your 
documents, files, and projects are 
saved to it as you work. 


Raspberry PI fan Jeff Geerling did 
a community favour by purchasing 
over a dozen different micro SD 
cards and benchmarking each one. 
The results were pretty dramatic, 
with some cards running up to four 
times as fast as others. Samsung 


L, 


and running 


ou don’t require much 

| to get your Raspberry Pi 
= started: a micro SD card 
from an old camera, a smartphone 
charger, a recycled HDMI cable, 
and a keyboard and mouse are all 
you need. 

Most items can be sourced from 
computer hardware around the 
house, or begged and borrowed 
from friends and family. If 
you’re looking for the ultimate in 
low-cost computing; the Raspberry 
Pi is it. 

You should be able to source, 
salvage, and scavenge most 
equipment you need to geta 


Evo+ and SanDisk Extreme 

are two popular brands worth 
Looking out for, and both are fairly 
cheap. You can read more at 
magpi.cc/2bncFs3 
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All the kit you need to get a Raspberry Pi up 
for the first time 


Raspberry Pi up and running. 
To get the most out of your 
Raspberry Pi in the long term, 
though, you should use high- 
quality components. 

A good micro SD card from 
a named brand will be faster 
and more reliable. Not all USB 
power adapters are born equal, 
either. A reliable branded adapter 
will provide a steady stream of 
power, even when you attach 
multiple devices. 

The Raspberry Pi board isn’t 
shy, and it’ll work just fine naked, 
but a good case keeps the board 
safer and makes it easier to store. 
There’s a huge range of cases 
available, and many offer unique 
features such as waterproofing, 
stackability, or wall mounting. 

The official Raspberry Pi case is 
a Slick piece of kit that’s perfect 
for any Pi user. Made of five parts 
that click together, it enables you 
to quickly open the case and access 
the board and GPIO pins. 

Any equipment you can’t 
oes can be dali up from 


(magp ve ninee or from 
distributors like Elementi4 
(element14.com), Allied Electronics 
(alliedelec.com), and RS 
Components (magpi.cc/2bnapBI). 
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Devices connected 
by Bluetooth work 
wirelessly with your 
Raspberry Pi 


Pairing mode 

Start by putting your Bluetooth device 
in Pairing 7 Discoverable mode. We're 
using an Apple wireless keyboard. 
Hold down the power button until the 
LED flashes. Click Bluetooth in the 
Panel and choose Add Device. 


The Add New Device window opens 
and will scan for nearby Bluetooth 
devices. Some will have names, 

others just identifying numbers (check 
on the device). Choose a device from 
the list and click Pair. 


The Pi now attempts to pair with the 
Bluetooth device. You'll be asked to 
enter a code on the keyboard; press 
the buttons and RETURN. You can 
now start using the Bluetooth device 


with your Raspberry Pi. 
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INTRO 


SHOWCAS 


Inspiring projects from around the world courtesy of the incredible people 
in the Raspberry Pi community 


i WAT 
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NEW YEAR NEW YOU 

Get on your resolutions 
with these Pi-powered 

New Years projects 


PIP-BOY 3000A 
Fallout's wrist computer, 
now available in the real 
world 


EYE-CONTROLLED 
WHEELCHAIR 
Hacking a wheelchair 
with 3D-printed parts 
and windscreen wiper 
motos 


SPACEHACK PI 

A game simulating a 
disaster aboard the 
Starship Guppy 


FABSCAN Pl 

An open source, DIY 
3D scanner made tiny 
with Pi 


ULTRASONIC 
THERAMIN 

Creating spooky 50s sci- 
fi effects with a range 
sensor and your hand 


SPARK CLUSTER 

Six Raspberry Pis 
connected together to 
make a modest super 
computer 


RAFTBERRY 

Pootling around a lake 
ona motorised raft and 
some beers 


MASON JAR 
PRESERVE 

Preserve your memories 
with this Pi-in-a-jar 


SUPER GAMEGIRL 

A 3D-printed RetroPie 
masterpiece that 
upgrades the humble 
Game Boy 


MINI MACPI 

The smallest Mac you 
ever did see, and it 
works too 


CNC MACHINE 
Woodworking with a bit 
of Pi-powered CNC to 
boot 


SEEMORE 

One part sculpture, one 
part supercomputer 
cluster, the SeeMore Is a 
work of art 


MAGIC MIRROR 

A high-tech mirror that 
lets you check the 
weather and much more 


RPI KIDS 

How one dad created a 
clever media centre for 
his kids 

RASPIMOWER DALEK 
Not quite exterminating 


the grass as much as 
giving It a nice trim 


2 SPY ROVER 


Upgrading an old toy 
into a remote-control 


SPY 
SNIFFUR 
Tracking the office 


pooch with some 
bluetooth beacons 


> KILIMANJAR 


A replica of the 
mountain that lets 
family members track a 
climbers ascent 


BALANCEBOT 

A robot riding around 
on two wheels that can 
also react to people's 
emotions 


EYE Pi CAMERA 

Taking beautiful and 
surreal IR photos with a 
Pi Noir 

PI DESK 

A space-age desk 
worthy of any starship or 
kids bedroom 


. HALLOWEEN 


PROJECTS 

Prepare yourselves for 
some spooktacular Pi 
projects 


P| ZERO PROJECTS 
Some amazing projects 
that make use of the tiny 
Pi Zero 
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e all like making New 

Year s resolutions. 

Sticking to them is another 
matter, and there’s only so many 
times you Can promise to give up 
cake and fail after three days. 

So, rather than resolving not to 
do something fun, we thought it 
would be a great idea to find the 
ereatest Raspberry Pi- powered 
tech projects with a healthy, feel- 
good vibe. The makers of these 
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projects have done us proud. What 
we have here are some of the 
world’s coolest projects to see you 
into the new year. 

These tech projects will help 
you live a little healthier, bea 
better citizen, and save some 
money to boot. Not bad, eh? More 
importantly, you can do all this 
while having fun. 

Living a little healthier is a great 
place to start, so our first project 


A digital bathroom 
scale is hacked to 
measure your weight 


is Dot Silverman’s Motivational 
Bathroom Scale. “You type your 
goal weight into the scales using 
the keypad,” explains Dot, “and 
the device compares your weight 
to your goal weight. 

“If you’re on target, it’ll give 
you a flattering compliment. 
Otherwise, itll sass you to get back 
to the gym. Remember that you’re 
beautiful, no matter what the scale 
might tell you.” 
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Enter your goal weight 
using the keypad, so 

the Raspberry Pi knows 
whether to give you grief 


A Raspberry Pi is hooked up 
to the scale and speakers to 
provide audio feedback 


The E-Wheelchair incorporates a 
Cooking Hacks E-Health v2 Sensor 
to monitor vital body parameters 
(cooking-hacks.com). The 
E-Health v2 and sensor 
attachments enable the 
Raspberry Pi to monitor body 
levels, such as blood glucose. 


One Raspberry Pi project maker 
making use of the E-Health 
Sensor is Prestem=Daseqee aul 
Case, whose life goal is to build an 
affordable smart wheelchair. Phil’s 
‘E-wheelchair’ is mind-controlled, 
using Neurosky MindWave Mobile 
and Mindflex EEG products to 


What We have here are Some measure the user’s brain activity. 


The E-Health system is used 
/ , to monitor electrocardiogram 

of the worlds coolest projects ey sone 
he plans to implement a body 


to see you Into the new year ees 


Phil is raising money towards 


If you want to get a little more thePitcmmeasune blood pressure, the development of his smart 
serious about monitoring health, oxygen levels, airflow, body wheelchair project, anda 
Cooking Hacks’ E-Health v2 sensor temperature, and glucose levels, GoFundMe page can be found for 
is worth investigating. It enables along with electrocardiogram and those looking to be more charitible 
you to connect nine sensors to electromyography results. in 2016 (gofundme.com/hfymdo). 
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Techfugees is a community response to the European 


refugee crisis. It runs conferences and hackathons, 
and uses a global network of collaborators to address 
the crisis in technological ways. 


The power of geeks to organise 
for a good cause was highlighted 
this year thanks to Techfugees 
(techfugees.com), a UK tech 
community response to the 
European refugee crisis. The 
initiative brings together hackers 
in the UK to crowdsource ideas. 
So far, Techfugees has organised 
two conferences and a hackathon, 
and raised £5,000 to provide free 
WiFi to the Calais refugee camp. 
So how about for the New Year 
you invest some time in providing 
tech skills to charities? 


The Raspberry Pi Piggy Bank uses a coin-sorting mechanism to place 


coins in the correct slots. It counts, sorts and stores coins using a Lego 


mechanism that rotates for each coin. A fingerprint sensor is used to 


provide access to the bank. 


So how about for the New Year you 
invest some time 1n providing tech 


Skills to charities? 


If your New Year’s resolution is 

to save more money, then take a 
look at Alex Strandberg’s amazing 
Raspberry Pi Piggy Bank. “After 

a COin is inserted, it’s placed into 
a stack with the same type of 
coin, explains Alex. “The LCD 
screen displays the total amount 
of money in the bank. If 1 want to 
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access the coin from inside, I hold 
my finger on the sensor to unlock 
the bank.” 

Another Lego Mindstorms- 
based project to investigate is 
the fabulous BrickPi Bookreader, 
built by Dexter Industries founder 
John Cole. This robot manually 
flips pages, photographs each 
page, and then reads it out loud. 


“We wanted to build a digitizer 
that could read books out loud,” 
John tells us. “We were fascinated 
by the Google Books project and 
thought ‘why couldn’t we build 
this at home” 

You’ll need a Dexter Industries 
BrickPi device and Lego 
Mindstorms equipment. The 
BrickPi turns a Raspberry Pi into 
the brains for Lego Mindstorms 
robots. It controls two Lego EV3 
motors: one pushes the pages 
up, and another acts as an arm 
and flips it over. The Pi Camera 
Module snaps an image of the 
page, and OCR software turns it 
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into text. “Just for fun, we used 
some free text-to-speech software 
so the Raspberry Pi reads the book 
out loud,” says John. 


If your New Year’s resolution 

is to get closer to nature, then one 
project you should look at is Sam 
Webster’s Tweety Pi Bird Box 
(magpi.cc/1lU7cN9Q). To be fair, 
there are lots of Raspberry Pi 
Dine box projects outim the wild: 
We really like Sam’s, though, 
because it takes things a 

bit further than most. Sam 

has fitted his bird box with 
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a PIR sensor, and hooked 
it up to Twitter. Whenever 
a bird flits into the box, it 
automatically starts sharing 
updates to @tweetypibirdbox. 
We're big fans of eco 
projects here at The MagP1, 
and learning how to use solar 
power in your Pi projects is a 
noble aim for the upcoming 
year. Solar panels can be picked 
up for around £20, and can be 
used to provide direct power or 
charge up an attached battery. 
Veteran maker Koff has a great 
tutorial over on Instructables 
(magpi.cc/1lU7fZh). 


This project 
uses a PiBrick 
and Lego 
Mindstorms kit 
to recreate the 
robots Google 
built for the 
Google Books 
project. It flips 
pages, scans 
them, and 
reads each 
page out using 
voice reader 
software. 


The Tweety Pi Bird Box uses a PIR sensor to detect 


movement, and the Pi Camera Module takes 
photos. A Python script then tweets each image 
from @tweetypibirdbox. It’s a fun project that lets 
you watch the birds in your garden. 
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0 


SOLAR POWERED 
RASPBERRY PI 


RASPBERRY PI 
WALL-MOUNTED 
GOOGLE CALENDAR 


ALEX PINE 


oa Pare ES 


= Alex Pine is an IT service engineer from 


Me or Js ; 
con saa 7) ae Fr. ee 0 .: Adelaide, South Australia. His projects 
A ero have been viewed over 800,000 times. 
magpi.cc/1Y94RtZ 


- Koff is an international man of mystery, 
’ but he’s been making stuff since the 
, 1980s and has some great projects on 
_ his YouTube and Instructables pages. 
magpi.cc/1lU7fZh 


This popular project turns an old HDMI monitor into 
a wall-mounted display that shows information 
from Google Calendar. The Raspberry Pi is placed 
on the rear of the monitor, and it is bracket- 
mounted to the wall. 


Running a Raspberry Pi from solar power is a great 


project. You get to learn how solar power works, Email is B) mod Crm curs or out 


and you can create devices that run outdoors 
under their own steam. 


GET ORGANISED 


If one of your New Year’s 
resolutions is to bea bit more 
organised (ours usually is), then 
we have three great projects for 
you to take a look at. The first 

is a fantastic wall-mounted 
Google Calendar by Alex Pine 
(magpi.cc/1Y94RtZ). You can 
use it to create a Shared calendar 
for yourself and your family, 

S@rcy clujole Can see exactly 
what’s going on. 

Our second productivity project 
is Michael Mitchell’s Inbox Zero 
Taunter (magpi.cc/1Y953cF). Email 
is a modern curse, but practising 
inbox zero can bring a lot of relief 
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practising inbox zero can 
bring a lot of relief 


from mail overload. The bright 
light of a Raspberry Pi LED reminds 
you that you’ve got email in your 
inbox that needs to be dealt with. 
It’s a super-simple project — just 
one LED and around ten lines of 
code — but once configured, it’ ll 
hassle you into clearing out an 
email account. 

Finally, if you’re in serious need 
of organisational help, then why not 
turn your Raspberry Pi into a voice- 
activated digital assistant? We love 
the Raspberri Personal Assistant 
by Jan Wante. He’s turned a1950s 


Bakelite Televox intercom into a 
voice-controlled digital assistant 
(think Siri inside an old American 
radio). Inside is a Raspberry Pi with 
a USB audio sound card, running 
Steven Hickson’s Voice Command 
software (magpi.cc/1Y95Pqc). 
You will undoubtedly learn 
something new from building any 
of these projects, and learning 
something new is the best New 
Year’s resolution you can make 
in any case. Whatever project you 
choose to build in 2016, make sure 
you have fun. 
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The Inbox Zero Taunter is a simple project that 
uses an LED connected to your Raspberry Pi. 

A Python script is used to detect emails in your 
Gmail inbox, and light up the LED. 


The Raspberri Personal Assistant 
project transforms a 1950s Bakelite 
speaker into a voice-activated 
personal assistant. Like Siri, it 

can be programmed to answer 
requests about the weather and 
news, or to take messages. 
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A combination of a 3.5° LCD 
screen and convex glass creates 
an authentic look for the Pip-Boy 


The Raspberry Pi is 
kept on the belt of a 
costume, as it won't fit 
properly into the case 


——— 


Quick 
Facts 


» Jesse 
completed 
the project 
between 
October and 
Christmas 2014 


» There are still 
a few buttons 
to add, but it's 
functionally 


complete 


» Fallout 3 and 
New Vegas are 
his favourite 
Fallout games 


» Jesse now 
wants to make 
a robot tank 
army with Pis 


» The cast for 
the case was 
from Nakamura 
Shop, and the 
RasPipBoy UI 
by Neal Corbett 
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The main parts fit into a 
3D-printed case that 
clips over your arm 
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Survive the radioactive wastelands or a cloudy day in town 
with a custom-made, wrist-worn computer 


he Pip-Boy from the 
Fallout video games is 
quite an iconic piece of 
kit these days. The fictional wrist 
computer’s functionality may 
be less amazing now than it was 
when the series debuted in the 
1990s, but the retro-futuristic 
look has kept it in certain corners 
of pop culture. Now, thanks to the 
reignition of interest in the Fallout 
franchise, the rise of makers, 
and the exploding popularity 
of cosplaying, every so often 
a new, home-made version of 
the Pip-Boy will turn up online 
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and go a bit viral. Even with the 
impending release of a special- 
edition version of Fallout 4 with 
an official Pip-Boy, people are 
still making their own versions, 
like Jesse Roe. 

“The project was an attempt to 
make a fully functional Pip-Boy 
3000A. Not something to stick a 
phone in, but an actual working 
device,” Jesse tells us, referencing 
the official Pip-Boy which will 
require a smartphone. 

Having never found a perfect 
use for his Raspberry Pi, Jesse 
decided to use it for this project 


he was making for a friend. Using 
a 3D-printed case that he modified 
himself, the build wasn’t simple. 
“T worked on this probably 
about 70 hours total, with a lot 
of that being just research,” Jesse 
explains about his build process. 
“There was a lot of stuff out there 
on making a Pip-Boy, where to get 
the cast from, materials, etc. The 
main piece to get was the Pip-Boy 
cast itself, which I ordered from 
Nakamura Shop on Shapeways. 
“Once it was in, we sanded it 
down and used model paint for 
the base with a darker green. 
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We detailed it up with scratches 
and other abrasions to look like 
a used model. I knew the suit as 
a whole needed to be separated. 
Too many people are so close to 
having a working Pip-Boy and 
get stuck when they say they 
can’t fit everything in there! I 
took a mechanics jumpsuit and 
put the 101 logo on the back as 
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The hardest and almost final 

part of the build was the screen. 

I ended up using a 3.5” TFT from 
Adafruit. The way the top bezel 
comes down and how you have to 
mount the screen means laying it 
down on something that covers 
all, for lips behind the bezel. 
Then after that, I had to lay 

a piece of glass on top of the 


I worked on this probably 
about 70 hours total, with a 
lot of that being Just research 


well as other details... | used an 
old army surplus belt with lots 
of compartments for a part of 
the suit as well, and put a hole in 
the suit so all the wiring could go 
from the belt, up the back, and 
to the Pip-—Boy. 

“Next was getting the Pip-Boy 
to boot into the slightly tweaked 
‘OS’ on startup, which was 
fairly simple. I ended up editing 
the code to have a different 
startup message for the ‘BIOS’ 
and whatnot, to make it more 
complete, but I didn’t mess with 
the software too much. 
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screen and glue it very lightly 
(but not too lightly) around the 
screen. Any mistake and you 
have to get a new Screen because 
either you’re going to glue it down 
off-centre or you’ll put too much 
on the screen.” 

Since Jesse hadn’t done 
much programming before, 
the modifications and setting 
up were a little tricky for him, 
but as you can see, in the end 
he managed to complete the 
project and walk around with 
a sweet Raspberry Pi-powered 
wrist computer. 


Pen OPERAT I uc / 


LPRAIS Mies 


Projects 


Vashington ary 2016, 9:24] 


Dials are 
to come, but the 
interface perfectly 
captures Fallout 3's 
Pip-Boy 


A handy 
army belt allowed 
Jesse to hide the 
electronics in 
the suit 
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The infrared eye sensor 
detects the motion of 
the user's pupil 


A windscreen wiper 
motor is connected 
to a small 3D-printed 
wheel. This wheel 


drives the main 


wheelchair wheels 


» The entire 
project took 
about 10-12 
months to 
complete 


» The files have 
been released 
under the CC 
BY NC licence 


» Originally, an 
Odroid was 
used instead of 
a Raspberry Pi 


» Arobot was 
used to test 
the software 


» The system 
can be used 
with any 
non-powered 
wheelchair 
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MEYRA 


Directions are spoken out 
loud and are confirmed 
using the pad 


Myrijam Stoetzer and Paul Foltin built an incredible eye-controlled 
wheelchair from 3D-printed parts, motors from a windscreen wiper, 
and a hacked webcam. Lucy Hattersley finds out all about it... 


yrijam Stoetzer and Paul 

Foltin, from Duisberg, 

Germany, have built 
this fantastic eye-controlled 
wheelchair. We caught up with 
Myrijam to talk about it. 

“We did it because eye-tracking 
was so interesting,” says Myrijam, 
“and then it occurred to us that we 
miei steer sOmetining: 

“While looking at different 
ways to build an eye tracker, 
we stumbled upon the Eyewriter 
project (eyewriter.org) from 
eraffiti artist Tony Quan.” 
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Tony suffers from ALS 
(amyotrophic lateral sclerosis) and 
can only move his eyes. “Tony was 
isolated for seven years before his 
friends helped him to paint and 
draw again using an eye tracker,” 
Myrijam tells us. “We wanted 
to help people like him be able 
to move again, because it is so 
horrible to imagine you couldn’t 
move any more.” 


Tracking eyes 
The eye tracker is a webcam 
modified to use infrared light and 


mounted on the frame of safety 
glasses. “We replaced the infrared 
blocking filter with a piece of 
analogue film that blocks nearly 
everything but infrared light,” 
explains Myrijam, “[then] we 
soldered in two infrared SMD 
LEDs in exchange for the white 
LEDs. This way, the eye will be 
illuminated by IR light, and the 
pupil reflects it back.” 

The camera is mounted 
inside a custom 3D-printed 
case and attached to the safety 
classes frame. 
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A windscreen wiper motor is connected to a small 3D-printed wheel. This small 


wheel drives the main wheelchair wheels 


“The camera films the eye, and the 
software extracts the position of the 
pupil and checks if it is within the 
range of four areas corresponding to 
the four movements,” says Myrijam. 

In the current version, the 
command is read out to the user 
via speech synthesis, and it has 
to be confirmed. Then the motors 
are switched on, depending on the 
direction. When the wheelchair 
is moving, infrared rangefinders 
check for obstacles in the path. 


coordinates of the pupil that has 
been filtered out so far: this was 
the biggest breakthrough.” 

The wheels are powered by 
windscreen wiper motors rescued 
from the scrapyard. “We wanted 
to keep it possible so everybody 
can simply rebuild it on their 
own,” Myrijam tells us. These 
motors are connected to the 
wheelchair wheels using a small 
3D-printed wheel contoured to fit 
around the tyre. 


Our biggest achievement was 
getting the tracker to find the 
coordinates of the pupil 


Raspberry Pi-powered 
The Raspberry Pi is used to capture 
images from the webcam, and 
OpenCV (opencv.org) is used 

for image manipulation. “The 
software captures images from 
the webcam with a frame rate 

of 10-12 fps,” says Myrijam. 

The image is converted to 
ereyscale, before being blurred 
and converted to black and white. 
“OpencCV offers a great filter that 
calculates the centre of gravity 

of a given shape,” she explains. 
“We use this function to get the 
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It was a challenging project: 
“Tt was very difficult to work on 
the code because this is our first 
time of leaving Lego Mindstorms 
behind,” says Myrijam. “Our 
biggest achievement was getting 
the tracker to find the coordinates 
of the pupil. After that, we knew 
it was possible. I learned to do 
3D design, 3D printing, Linux, 
Python, and image processing. 

It was amazing to see that you 
can integrate computer vision 
into your projects and combine 
that with physical computing.” 
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Alarming messages like ‘Set 
multitronic filter to magenta alert!" 
pop up on each space cadet’s console 


< 


A Raspberry Pi board controls the 
game and keeps score, although an 
untimely end is inevitable for all of the 


hapless crew 


DANGER OF DEATH 


KEEP OFF 


MQTT sends instructions to the 
consoles over local intranet - 
usually not the console with the 
control that needs adjusting! 


» Console One 
still features 

its original 
spaghetti wiring 


» SpaceHack 
has featured 
at around 15 
maker events 


» For Towel Day 
it became 

the Infinite 
Improbability 
Drive 


» The laser cutter 
used lives in 
Rob Whitfield’s 
bedroom! 


» SpaceHack 

uses the same 
communications 
protocol as 
Facebook 
Messenger 


SpaceHack's 
retro-futuristic 
look seemeda 

natural fit in the 
MakeFest setting 
of Manchester's 
Museum of 
Science and 
Industry 


Join the unfortunate trainee crew on the Starship Guppy, 
as things begin to go badly wrong, and chaotic fun ensues 


hat other fast-paced, Pi- 

based console game lets 

you shout “Set multitronic 
filter to magenta alert!” to the 
general puzzlement of passers- 
by? York Hackspace have been 
drawing a lot of attention at maker 
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events over the past year or so, 
fulfilling their aim of creating 
something memorable for visitors 
to their stand. 

It was Bob Stone who suggested 
a physical version of Henry Smith’s 
Spaceteam, a ‘cooperative shouting 


game for phones and tablets’, but 
given the definitive Hackspace twist 
with its retro-futuristic spaceship 
looks, and homebrew hardware 

and software, “it would sort of 
advertise itself within the room, 

as yelling nonsense with a sense 

of urgency and panic tends to draw 
attention in crowds.” 


Disaster simulator 
“Welcome aboard the USS Guppy, 
recently refurbished to the very 
highest standards of modern space- 
worthiness by some new lowest- 
bidding contractors we found on the 
net. We’re proud that this venerable 
old boat, a veteran of many a heroic 
space battle, has once again been 
declared officially ‘Good enough 
for Government work.’ ” 

The hints are all there before you 
start your “routine pass out by an 
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SPACEHACK 


Projects 


MAKING OF THE CONSOLE GAME 


>STEP-01 


asteroid belt orbiting an unstable 
Red Giant star near the edge of the 
Forbidden Zone, to investigate some 
unusual radiation signatures.” 
SpaceHack’s control panels have 
been reconfigured, and as things 
begin to go wrong on the space 
mission, emergency instructions 
issued by the ship’s computer 
— showing on the console’s LCD — 
don’t seem to apply to that console’s 
switches, dials, and buttons. The 
only way to avert disaster is to shout 
out the instructions so that fellow 
space cadets at one of the other 
three consoles can search for the 
right switch to flip, dial to turn, 
or button to push. 


Ing Jam 
How long can disaster be staved 
off° There’s no shortage of 
volunteers to find out, whenever 
the York team brings SpaceHack to 
an event. If you follow the maker 
events online, you’ll have seen the 
favourable comments. Spotting 
a couple of familiar faces playing 
SpaceHack at the MOSI MakeFest, 
we asked them what they’d 
thought of the experience. 

“T thought playing it was 
ereat fun and highly engaging. 
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Welcome aboard the recently refurbished 
USS Guppy, once again declared officially 
‘Good enough for Government work’ 


The intentionally confusing 
instructions add to the madcap 
antics and to me were reminiscent 
of TV’s The Generation Game 
challenges, where contestants 
struggled with seemingly simple 
activities,” Raspberry Jam’s 
Alan O’Donohoe told us. Claire 
Garside invited the York team to 
Leeds Raspberry Jam, and was 
enthusiastic about SpaceHack’s 
ability to excite people about STEM 
in a fun way: “Whether taking the 
challenge myself, or observing 
the wide range of contestants it 
entices, SpaceHack always initiates 
an enthusiasm and excitement for 
everyone through gaming with Pi. 
And I do mean everyone!” 

If you’d like the chance to 
shout “Plug in the centrifugal 
F-screen!”, then look out for 
SpaceHack at Derby Maker Faire 
on 26 October — and if you want 
to build your own, full details 


are up at magpi.cc/2dTHzwu 
for the hardware (including 
laser cutting and 3D printing), 
console software, and Raspberry 
Pi controller software. 

“Increase the omnicrontensor 
shell! Set multitronic filter 

to magenta alert!” 


Below Families 
are naturally 
drawn to what's 
best described 
as ‘a game of 
collaborative 
shouting’ 
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FABSCAN P! 


MARIO LUKAS 


Mario Lukas is a hardware hacker, 
computer scientist, and technology 
tinkerer from Aachen, Germany. 
mariolukas.de 


Mario Lukas builds 3D scanners from the Raspberry Pi and off-the-shelf 
components. He tells Lucy Hattersley how it’s done 


All the parts 
cost less than 
$100 in total 


Commercial 
scanners cost 
around $3,000 


The FabScan 
software 
creates PLY and 
STL files 


The mesh files 
can be used 
to 3D-print 
objects 


Mario is 
experimenting 
with dual and 
green lasers 


The 
Raspberry 
Pi is housed 
inside the 
box and 
runs a web 
interface. 
You connect 
to the latter 
remotely to 
begin the 
Yorslalallare| 
process 


ew things in modern life are 
more fun than 3D-scanning 
an object, then using a 
3D printer to create a copy. But 3D 
scanners are still very expensive to 
buy. FabScan is an open-source, DIY 
3D laser scanner being developed by 
René Bohne and Mario Lukas. 
Initially, FabScan was connected 
to an external computer, but Mario 
and René have recently created a 
Raspberry Pi version that houses 
all the components required inside 
a single box. This Raspberry Pi- 
powered edition means you can 
build a complete 3D scanner for 
under $100 (£65). 


RTFM 


wwrw.watterott.com 
Your open Hardware source 
ww 4 three 
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The FabScan project has a long 
history. It started out as a Bachelor’s 
thesis by Francis Engelman at RWTH 
University in Aachen (Germany) 
in 2011. In 2014, development was 
taken over by Mario and René. 

“The FabScan without the 
Raspberry Pi is an open-source, 
do-it-yourself 3D laser scanner,” 
says Mario. “After a few months 
I realised that people had 
problems [getting] the FabScan 
software working on all the 
different operating systems and 
hardware setups. 

“The FabScan uses a laser cut 
plywood case,” continues Mario. 


There is a stepper motor connected 
to a turntable in the middle.” Inside 
the case isa5mW red laser and 
Logitech Lc270 webcam. The laser 
and a webcam are mounted in the 
front of the case. An Arduino with a 
FabScan shield controls the stepper 
motor and laser. 

You place an object on the 
turntable so the laser runs across its 
surface. As the turntable rotates, the 
webcam monitors the movement of 
the laser and creates a point cloud 
of data. The data is turned into a 3D 
mesh, and this file can be exported 
and used in 3D software. 

“Since I introduced the 
Raspberry Pi to the 
FabScan project, 
the webcam [has 


The wooden case 
contains a motorized 
turntable that rotates 
the object being 
scanned. It is currently 
controlled by an Arduino, 
although a custom Pi 
HAT is being developed 


A5mW red 
laser is fixed in 
the corner of 
the FabScan. It 
projects a line 
directly across 
the turntable. 
A Pi Camera 
Module is used 
to monitor 

the laser as 
the object 

is rotated 
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Box construction 


The FabScan box is laser-cut from wooden 
parts. A stepper motor, controlled by Arduino, 
is used to control the wooden turntable. The 
laser is mounted in the corner and emits a 


line diagonally across the turntable. 


been] replaced by the Pi Camera 
Module,” Mario tells us. “We 
are developing a FabScan Pi HAT 
to replace the Arduino and the 
FabScan Shield as well.” 

You can build a FabScan case 


>STEP-02 
The Raspberry Pi 


contained 3D scanner. 


enabled user interface for scanning. 
The user can call the local FabScan 
in a browser and the user interface 
will show up. 

“During the software developing 
process, I scanned a lot of different 


| Introducing the Raspberry P1 to 
the FabScan project was a good 
approach to improve the usability 


yourself using sheets of wood, and 
a complete bill of materials can 

be found at magpi.cc/2dTI8WT. 
Alternatively, a FabScan Cube Kit 
v2 + Electronics bundle can also 
be ordered from German-based 
distributor Watterott (magpi. 
cc/2dT]jSi) for €105 (£77). 

“Anybody who wants to build a 
FabScan Pi should order the parts 
and build it,” insists Mario. “We are 
trying to keep the things as simple 
as possible, and introducing the 
Raspberry Pi to the FabScan project 
was a good approach to improve 
the usability. 

“Most of the work was to write 
new software for the FabScan,”’ 
continues Mario. “The software 
provides a JavaScript-based web- 
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rubber ducks, other plastic animals, 
figures made of gypsum (plaster 

of Paris), and stuff lying around in 
my workroom. 

“After a scan, you will get a one- 
to-one sized three-dimensional 
model of the scanned object,” 
explains Mario. “The current 
FabScan Pi software can export the 
model in [the] STL file format that is 
mostly used by 3D printers.” 

Pushing forward with the FabScan 
project is a challenge, but Mario 
and René remain unperturbed. 

“At the moment, the FabScan 
project is spread all over the web,” 
explains Mario. “In the upcoming 
weeks, I will try to create a website 
where all corresponding threads 
run together. 


The Raspberry Pi runs the scanning 
software, and a Raspberry Pi Camera 
Module is used instead of a webcam. Using 
a Pi enables the FabScan to become a self- 


>STEP-03 

Scanning the duck 

An object (in this case a rubber duck) is 
placed on the turntable. The web software is 
used to connect to the Pi-powered FabScan. 
As the duck rotates, the camera monitors the 
laser and uses it to create the scan. 


Above The 
Raspberry Pi 2 has 
enough power 

for a FabScan 


“Currently Iam working on 
some DEB packages for Raspbian 
to keep the installation process 


! 55 to work without 
as Simple as possible,” reveals being attached to 
Mario. “The next step is releasing a another computer 


Raspbian image with a pre-installed 
version of the FabScan Pi software. 

I also have a huge to-do list with 
new features mentioned by the 
FabScan community.” 


Above The FabScan software is used to create a 3D mesh from 
the point cloud data detected from the scan 
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Place your hand over 
the Pi and, in turn, 

the ultrasonic sensor 
to start making noise 


» Linus had 
been using his 
Raspberry Pi 
as a HTPC 


» This was his 
first electronics 
project of 
this type 


» It only took him 
an evening to 
make and two 
hours to fine- 
tune 


> It's held 
together with 
electrical tape, 
which is not 
recommended 


» Linus hopes 
to add light 
guides for 
better accuracy 
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All the sound output 

is done by this old PC 
speaker, which requires 
no extra power 


Apparently it can lag a bit 
on this original Model B 
after some time, but it will 
work a lot better on a Pi 2 


LTRASONIC 


An inventive use of the Raspberry Pi that makes use of the kind 
of components you might have lying around the workshop 


hinking outside the box 
is what we like here at 
The MagPi. The Raspberry 
Pi is So versatile and so open 
that you can do so much with 
it that perhaps other people 
wouldn’t have dreamt of before. 
So here’s a good question: with 
a Raspberry Pi, some speakers, 
and an ultrasonic distance sensor 
used for robotics, what would you 
make? Linus Forslid decided to 
build a type of theremin. 

“A theremin is a device that 
measures distances to objects 
nearby and turns that into 
sound, so that when you move 
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your hands around it, you can 
generate music,” Linus explains. 
It’s not exactly like a normal 
theremin, though. “Unlike a 
classic theremin, my project 
uses an ultrasound sensor rather 
than measuring electrical fields 
with antennas, and currently my 
project only has a single sensor, 
So you can only control the tone it 
produces. Eventually, I plan to add 
another so that the beat can also 
be manually controlled.” 
Theremins were used to create 
the eerie, creepy music for classic 
sci-fi films. Due to this and its 
unusual method of operation, the 


theremin has become intriguing 
to many musicians and techies, 
including Linus: 

“lve always wanted a theremin, 
from the first day I heard of it. It’s 
just such a cool thing. As it turns 
out, though, an actual theremin 
is not cheap or easy to build, but 
this project was easily doable and 
I had almost all of the components 
at home already, so the cost was 
minimal as well. I decided to use a 
PC speaker instead of the Pi’s own 
audio jack and an external speaker, 
mostly because I could, in addition 
to it not requiring an additional 
power source.” 
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It's all hooked up to the 
GPIO ports rather than using 
any USB speakers or sensors 


CREATE MUSIC 
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I've always wanted a theremin, 
from the first day I heard of it. 
It's just such a cool thing 


The hardware is one thing, but 
actually translating it to sound, 
surely that takes a bit more work 
on the code to get it operational? 

“Not really, I think.” Linus 
adapted some pre-existing code 
for the project. “The script that 
controls the theremin is coded in C 
using wiringPi, and it took maybe 
an hour to get it working. I’ve spent 
a couple of hours beyond that just 
tweaking the numbers to try out 
different sounds and find one! like. 
I wouldn’t say it was complex, even 
if the tuning took a while.” 

The whole process is deceptively 
simple then, even though it’s 
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hardly your typical Pi-based 
project. There are a few caveats, 
however, and Linus’s Pi-powered 
theremin could do with a few 
MamyONeSraMKeN TTS. aks Inver es qo lreblnls: 
“It’s surprisingly hard to 
operate well, as you need a very 
steady hand and good aim to get 
the exact tone you are after... 
I plan to add another sensor to 
control the beat of the sound. 
Right now, it is set entirely by 
the script, which means it’s 
basically static. By allowing the 
user to control the beat, my hope 
is that it will actually be useful as 
a musical instrument.” 


>STEP-02 


>STEP-03 
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Six Raspberry Pi boards 
are housed together 
inside the enclosure 


An Ethernet router is 
used to connect the 


devices together 


» Pis aside, the 
parts only cost 
around $60 


» 106 screws are 
needed for the 
enclosure 


» Acluster of 
Raspberry Pis is 
also known as 
a ‘Bramble’ 


» GHCQ has 
the largest 
Pi Bramble: 
66 boards 


» China's Tianhe-2 
is the biggest 
supercomputer: 
3,120,000 cores 


One of the Raspberry Pi units 
is the master; it controls the 
other Pi boards 


DATA CLUSTER 


One data scientist shows us how to string six Raspberry Pis together to 
build a Supercomputer and experiment with big data 


he Raspberry Pi is great for 
learning computer science, 
but there’s one area 
that’s big news but requires big 
computers, and that’s ‘big data’. 
Big data software typically 
runs on clusters of networked 
computers, working together to 
perform the heavy lifting required. 
This clustered nature makes 
learning big data tricky, because 
you need several computers wired 
foOcether (O)practise, Sule=lack 
Kim, a software engineer from 
Korea, decided that the Raspberry 
Pi would be perfectly suited to 
the task. “Raspberry Pi is a great 
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education platform to learn how 
big data software works,” he tells 
us. “It is [comparatively] slow and 
low-powered, [so] that you would 
have hands-on experiences when 
your data manipulation methods 
execute as planned.” 

In fact, the light performance 
of the Raspberry Pi becomes an 
advantage when learning big data 
techniques. “Once you miss a 
small detail,” explains Sung-Taek, 
“you feel the operation processes 
slow down.” 

“Sending data across [a] network 
takes time,” he adds. “All the 
CPUs in your cluster compete for 


resources such as memory or disk 
[space], and a node or two could 
suddenly refuse to work, just like 
[in] a Google-class data centre 
cluster.” He explains that the 
relative slowness of a Pi cluster is 
actually an advantage, enabling 
you to prepare for such events. 

Sung-Taek’s cluster is based 
around six Raspberry Pi 2 boards 
wired together with Ethernet 
cables via a D-Link 8-port Gigabit 
Desktop Switch. 

“Theoretically, you would only 
need one Raspberry Pi,” says 
sung-Taek, “since Spark exploits 
the [nature] of a master-slave 
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scheme. Prepare a Raspberry Pi as 
a Slave and your laptop as a master. 
Connect two Raspberry Pi devices 
and you have a Spark cluster.” 

Sung-Taek suggests using 
between three to eight Raspberry 
Pi boards for the project. “Once you 
have more than ten Raspberry Pis,” 
he says, “it’s a headache to find a 
proper power source, to arrange the 
network and power cord.” 

The hardest part seems to be 
building the enclosure. Sung-Taek 
hosts schematics on GitHub 
(magpi.cc/2dTIn4z), but accuracy 
is vital. Even a half millimetre 
offset in the cutting template 
could render one of the acrylic tiers 
useless, he warns. 


as well.” Java is another must, and pie | iG A HI 

the listed software packages include ANAT RttTTOT - 
NumPY, Scipy, and Scikit-Learn. OFAL , . at 
On top of that, you’1l be learning 
the MapReduce programming 
model, which is where you’ ll 
encounter Hadoop and Spark. 

They are all skills worth learning, 
though: big data is at the forefront 
of computer science and is an 
interesting area to study and work 
in. “The Raspberry Pi cluster lets 
you prepare [for] events that 
could take place in a production 
environment,” says Sung-Taek. 
“Further, the cluster lets you easily 
find where to apply optimisation 
work, since its hardware resource 
is limited indeed.” 


>STEP-01 


Building the case 


The schematics for the boards can be found on Sung- 
Taek's website. You can use wood, synthetic, or acrylic 
panel to cut out the shapes, so long as each is no thicker 


7H Once you have more than ten 
Raspberry Pis, its a headache 
to find a proper power source 


Aside from the Raspberry Pi 
units, the project isn’t expensive. 
The power supply, network switch, 
cables, screws, and enclosure only 
came to around S6o. A complete 
list of materials is available viaa 
Make: article (bit.ly/1J2jpDf) written 
by Sung-Taek. 

The software requirements are 
quite intense. “Python is a must,” 
he says, “In order to fully exploit 
what a Spark cluster provides, it 
would be a good idea to learn Scala 


IY Worn 
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“You might want to plan 
carefully and start with a small 
number of nodes,” he advises. 

“Pay attention to details in each 
step, and make sure your plan is 
checked with specifications. Once 
you’ve successfully built [a cluster], 
make a bigger one. One of the best 
Strategies to avoid costly mistakes 
is to follow and observe what others 
have done.” 


Below Six Raspberry Pi devices are used 
to build the supercomputer 


than 3mm and strong enough to hold a USB charger. 


‘ 
>STEP-02 


Cluster assembly 

The Raspberry Pis are attached to the boards using 
M2.5 screws. Then use 5mm pillar screws and hex 
nuts to screw the boards together. 


>STEP-03 

Hooking it up 

The six-port router is held in the middle of the boards. 
Each Raspberry Pi connects to the router via Ethernet. 
Notice that the case leaves enough space for a power 
socket for each Raspberry Pi. 
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SHOWCASE 


The most important part 
about such a craft is that 
it floats. And it does 


» The raftBerry 
had been 
planned 
for about 
two years 


» Yves hasn't 
programmed 


since university 


» The raftBerry 
has all the 
required 
boating safety 
equipment 


» Yves wants 
to add crazy 
lighting 
and ‘look to 
steer’ systems 


» For the 
military, Yves 
has used 22 
Raspberry Pis 


For a watercraft, this is quite a 
simple selection of controls to 
get it work, all hooked to the Pi 


Cruise in style, with music 
and DVDs to keep you 
entertained out on the water 


Escape a desert island with your volleyball BFF in style, or just pootle 
around a lake with some pals, with this Raspberry Pi-powered raft 


icnics are fun. You fish 
! acooler bag from the 

back of a cupboard along 
with some half-forgotten freezer 
blocks from the ice tray and fit 
in as many sandwiches, sausage 
rolls, and cans of soda as you can. 
After grabbing some family or 
friends, you find a nice spot and 
eat outside. Wonderful, aside from 
the inevitable invasion by ants, but 
still great. What if you could take 
ants out of the equation, though? 
You could if you were somehow 
able to have a picnic out in the 
middle of a lake. Meet Yves Daigle 
and his raftBerry project... 

“The idea is to create a fully 
autonomous electrically propelled 
floating dock, controlled bya 
Raspberry Pi, to drive us around 
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our lake,” Yves tells us. As you can 
See irom the resulting picture of 
Yves and some friends enjoying a 
meal on the floating dock, the idea 
has come to fruition. 

As an aerospace engineer 
serving in the Canadian Air Force, 
Yves is used to creating complex 
equipment, so it’s no surprise that 
this side-project is not exactly 
simple as well: 

“The control system has 
two available modes that can 
be selected via a switch on the 
console: manual or autonomous. 
The dock uses two static motors for 
propulsion that can also steer the 
dock via differential thrust. 

“The Pi reads inputs via the 
GPIO from the arcade joystick, 
emergency shutdown button, and 


mode select switch. Each motor is 
independently controlled by five 
automotive relays, three of which 
are used to set the speed, and 
the remaining two are used in an 
H-bridge configuration to set the 
motors in forward or reverse. The 
GPIO output pins control a small 
eight-channel relay board, which in 
turn controls these ten automotive 
relays. The whole system, from 
motors to control panel, is designed 
to be removed from the dock after 
every trip, using a hand truck.” 
The whole thing took him a 
month to finish after he started 
to properly work on it and also 
includes a DVD player, a table, 
seating, and a camping stove. 
Less of a picnic, then, and more a 
floating campsite. 
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“Manual mode works 
flawlessly,” Yves explains. 
“The relays do get quite hot and 
full speed appears to not be as 
powerful as it was with the original 
control head. I suspect the relays 
are nearing max load and are 
causing some voltage drops. | plan 
to acquire larger relays. The motors 
may be a little underpowered.” 

Automatic mode doesn’t quite 
work right now, but Yves is 
working on it. As well as using 
Raspberry Pis at home and on 


raspberrypi.org/magpi 


A floating picnic for everyone, 
thanks to a little hacking 


It Looks like a phone cabinet, 
but everything within each 
subsection is quite simple 


watercraft, he’s been using them 
in his job; “We have 22 of them 
performing various tasks at the 
moment. I’ve found that Pis 

are several orders of magnitude 
more cost-eifective than 
commercial alternatives. Saving 
taxpayer dollars is something I 
take quite seriously.” 

If you want to see some of the 
build, along with the raftBerry 
in action, you can check out the 
video of it on YouTube: 
youtu.be/FZvU3U1wZWo 


_Saper Turbo Power Dock 9000 
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The Raspberry 


Pi is housed 


vertically inside 


the Mason jar 


The lid is 
connected to 
the wooden 
base, and 
holes are 
drilled in it 
for the LEDs 
and cables 


Quick 
Facts 


» The Mason jar 
was invented 
in 1858 by 
tinsmith 
John L Mason 


» You can buy 
Mason Jars in 
the UK from 
Kilner - 
kilnerjar.co.uk 


» Don't overclock 
the Raspberry 
Pi, as it could 
overheat 


» The only 
storage 
limitation 
is what you 
attach to the 
Raspberry Pi 


» Matt used 
Nodes to get 
the LEDs to 
work in time 
with BitTorrent 
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MASON 
PRESER 


att Reed, a professional 
web developer and maker 
from West Virginia, has 
created this amazing project. The 
Raspberry Pi-powered Mason 
Jan Presence io themes cmmich 
backup solution we’ve ever seen. 
At this point, The MagPi’s non- 
US readers might be wondering 
what on earth a Mason jar is. 
“They are industrial-grade 
elass jars with a sealable lid that 
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were originally used at home 

to preserve foods throughout 

the winter,” says Matt. “Mason 

jars allowed for foods that were 

harvested in the summer 

to last all year round. Who doesn’t 

want tasty fried okra in February? 
“In my great-grandmother’s 

basement, there were shelves and 

shelves of various-sized jars filled 

with everything from pickled 

beets to you-name-it preserves.” 


Matt Reed backs up his family photos in a Mason jar. He tells 
Lucy Hattersley how to preserve digital memories in style 


The LED lights flash in time with 
BitTorrent sync activity to produce 
the red glowing effect when the Pi is 
preserving files 


AR 


But rather than preserve tasty 
foodstuffs, Matt’s Mason jar 
preserves Matt’s family memories. 


Canning a Raspberry Pi 
The idea came to Matt at work: “1 
had a few various-sized Mason 
jars sitting around. One day | just 
erabbed the largest jar and slid 
the Pi inside. It fit, even with a 
little room to spare!” Building 

the Mason Jar Preserve was fairly 
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straightforward: “I used a saw to 
cut the base into a Square, a Sander 
to round it off, and a drill to make 
Ee IBID) le lveiinvet. sia joChel 
holes. A few trips to Home Depot 
for antique drawer pulls, some 
rubber feet, brackets and screws, 
and that was it.” 

Matt’s Mason Jar Preserve 
connects via Ethernet, but you 
could use WiFi. “I am still curious 
how much glass would affect 
the signal,” he tells us. “In the 
end I chose Ethernet for transfer 
speed, availability, simplicity, and 
reliability. Also, because I was low 
on USB WiFi dongles. Like, zero.” 


Powered by BitTorrent 
Matt used BitTorrent to create the 
backup software. “It’s similar to 
Dropbox,” he says, “but instead of 
a centralised server in the cloud, 
you connect two or more of your 
own devices directly together 
over the BitTorrent protocol. 
Just like Dropbox, connected 
BitTorrent sync machines all 
sync up a specified folder on their 
system. So basically, it’s free and 
the storage is only limited to the 
connected storage.” 

Unlike BitTorrent file sharing, 
Matt’s system is completely 
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private. “Whenever you create a 
sync folder, it gets a unique string 
of letters and numbers,” explains 
Matt. “This key uniquely identifies 
it over the BitTorrent sync 
protocol. Keys can provide either 
read/write access or read-only 
access to anyone you give it to. You 
generally want to keep them safe. 
If | shared that key publicly, then 
I'd have a public file-sharing seed 
Similar to the BitTorrent everyone 
knows and loves.” 

Matt uses his the Mason Jar 
Preserve to back up family photos 
and videos. “I really just wanted 
one more layer of redundant 
backup of things like the birth 
of our kids, wedding photos, and 
various family-related media. It 
uses the Raspberry Pi’s SD card 
for storage. Therefore, the larger 
the SD card you put in your Pi, the 
more you can store.” 

We think the end result is 
glorious. When the Mason Jar 
Preserve is syncing, it animates 
the LEDs using the Node.js script, 
BitTorrent Sync API, and the GPIO 
pins. When it sits idle, they glow 
red. “I wanted it to look like the 
jar was filled with red raspberry 
preserves,” says Matt. “It 
especially looks great at night.” 


Some furniture fittings from Home Depot 
were used to embellish the design 


The Mason jar looks especially good in low 
light when its LEDs are illuminated 
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If you're sick of bad 
Super Mario Bros 3 levels 
in Super Mario Maker, try 
out the original on this 
3.5 screen with many 


other games 


AMEGIRE 


» This was Chris's 
first Raspberry 
Pi project 


» The volume 
wheel is from 
a Game Boy 
Advance 


» Chris created 
custom PCBs 
for this project 


» Unfortunately, 
it doesn't run 
Nintendo 64 
games well 


» Chris's favourite 
game to play 
on it is Super 
Mario Bros 3 


There are enough 
buttons to play all major 
home consoles up to 


. the PlayStation 


A mixture of old and new: a 
GBA volume control and USB 
input for loading ROMs 


Want a better handheld games console? The answer may be 
to make one yourself with a Raspberry Pi and a 3D printer 


ver the past few issues, 

we’ve covered a handful 

of retro gaming projects 
of varying types: a refurbished 
SNESya 3D>pimlcd NES a Power 
Glove running games, and So on. 
While these are all definitely cool 
projects, you know what’s really 
cool? A portable retro gaming 
machine! In the past, this spot 
has typically been taken up by the 
very hackable Sony PSP, but Chris 
Duerden made the decision to go 
down a much more homebrew 
route by making his machine from 
scratch using the same Raspberry 
Pi that powers those other retro 
gaming projects. 
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“My project is a Raspberry 
Pi 2-powered Game Boy-looking 
thing,” Chris tells us. “It runs 
RetroPie, so it can play games 
from a lot of different systems. 
The goal was to have enough 
buttons to support PlayStation 
games, have a3.5 screen, and 
enough battery life for seven hours 
of play while being smaller than 
the original Game Boy!” 

The seven hours requirement is 
so it can survive a long plane trip, 
something modern handhelds 
can’t quite handle. “I love retro 
gaming and wanted something to 


do while travelling,” Chris explains. 


“T didn’t want to have to bring a 


case full of game cartridges or AA 
batteries with me everywhere, and 
wanted it all-in-one and easy to use 
for anyone that would play it.” 

The idea came to him after 
learning about RetroPie, and he 
began to tinker with the Raspberry 
Pi. The whole thing is custom- 
made, and it starts with a Raspberry 
Pi 2 and a 3D-printed case. The 
case takes the Game Boy as its 
base inspiration, adding more face 
buttons as well as shoulder buttons 
to accommodate PlayStation (and 
other console) games. There’s a 
3.5. screen, a6000mAh portable 
battery, amps, speakers, jacks, 
LEDs, and various buttons and 
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The buttons on the rear are 
very basic, but Chris is unsure 
how to improve them 


ie 


Enough battery life for seven hours 


of play while being smaller than 
the original Game Boy! 


switches cannibalised from a NES 
and several Game Boys. 

“It was complex to get 
everything to fit and work 
together,” Chris admits. 

“| designed thie housing in 
SolidWorks, wrote programs for 
the Pi in Python, programmed 
the AVR in C, designed custom 
circuit boards, lots of breadboard 
time, some talking to Adafruit to 
see what their products can and 
can’t do, etc. But it was relatively 
easy to build.” 
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The result works well enough 
for Chris, with power on and off 
switches, games loading from a USB 
port on the side, and the ability to 
charge the battery from the bottom 
of the case with a micro-USB cable. 

Right now, Chris is making a 
second one for his girlfriend and 
will eventually write up a full 
rundown on how to make your 
own, including slightly improved 
plans for the circuit boards. Soon 
you'll be able to make long trips 
much more interesting. 
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MINI PI 


Arguably the smallest, cutest classic Mac-inspired project, the Mac Mini Pi 
is actually much more than a swanky case for your Raspberry Pi... 
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dafruit knows a thing 
A or two about building 
impressive Raspberry Pi 

projects, and the Ruiz brothers’ 
Mac Mini Pi - originally inspired 
by RetroMacCast’s John Badger - 
is certainly no exception. Besides 
being an unashamedly cute design, 
this tiny Mac is much more thana 
fancy case for your Raspberry Pi — 
it’s a fully functioning emulator, 
So you can relive those Mac OS 7 
glory days (or experience them for 
the first time). The software used 
for emulation is a flavour of Mini 
vMac (magpi.cc/2dq3foj) 
that perfectly emulates early 
Macs that ran Motorola’s 680xo 
microprocessor. The software runs 
happily alongside Raspbian, too. 

Adafruit.com’s guide includes 
everything you need to build the 
project yourself, including detailed 
instructions and the files you need 
for the 3D print (you can use a 3D 
printing service if you lack a printer 
of your own). Under the hood, the 
project uses a standard Raspberry 
Pi Model B, the 320x240 3.2” PiTFT 
screen, a3.7V lithium-ion battery, 
and a simple audio amp, among 
other things. Some basic soldering 
skills are a must and you can expect 
to spend most of the weekend on 
the build itself (it’s fiddly!). 

You can check out this amazing 
project in its entirety at: 
Magpi.cc/2dq4eox 
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The CAD design of the Mac Classic-style chassis itself. 
You could send the design off to a 3D printing service or pop 
into your local makerspace to get it printed 
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Unsurprisingly, all the components you 
need are easily picked up from adafruit.com. It's 
going to cost you around $80 before 3D printing 


Once the electronics are sorted, putting the chassis 
together is quite fiddly — it definitely requires a steady hand 
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Quick 


» The project 
started asa 
challenge from 
a colleague 


» This was Mark's 
first Pi project 


» The controller 
wires terminate 
in aircraft 
connectors 


» The power 
supply comes 
from an LED 
lighting set 


» A buffer 
prevents 
leakage current 
triggering end- 
stop relays 


PI-POWERED 


How do you combine a passion for beautiful woodworking with an interest 
in electronics? Mark Buttle did it with a Pi-powered CNC machine... 


ural Shropshire, one of the 
coldest and wettest parts of 
England, is home to many 
makers and inveterate tinkerers, 
with plenty of time holed up in 
the maker shed, allowing genius 
to ponder and grow. In fact, the 
county has a history of makers and 
thinkers, being the place of origin 
both of Charles Darwin, and of the 
industrial cradle of Ironbridge. 
Mark Buttle is an engineer who 
loves to work with wood. His 
home is full of lovingly handmade 
furniture, as well as quirky items 
like a fridge-freezer masquerading 
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as a traditional red telephone box 
(naturally, there are plans fora 
familiar blue police telephone 
box, too). But Mark is a software 
engineer by day, and also interested 
in electronics, so is happy to 
mix technology with traditional 
crafting skills. 

Mark had originally bought an 
Arduino as a birthday present 
for a colleague and, intrigued 
by the board’s possibilities, had 
then bought one for himself. 
The colleague set a challenge, to 
see who could come up with the 
most interesting project, and 


Mark began looking into building 
a Computer Numerated Control 
(CNC) machine for woodworking. 

It soon became apparent that the 
Arduino, while ideal for controlling 
the stepper motors, would need 
some extra help, and Mark certainly 
didn’t have time to write all of the 
software himself. Research online 
turned wp bot Grbl= the open= 
source controller code that runs on 
the Arduino — and the Zapmaker 
controller software, which is 
written for the Raspberry Pi. 

“Td wanted a Pi for a while,” 
Mark tells us. “This is the first 
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APi 2 runs the open- 
source Zapmaker 


software to send G-code 
to the controller board 


An LCD screen in the 
controller box shows Mark 
the current position of 

the machine, and overall 
progress of the cut 


= he ee 


The Arduino controller 
runs Grbl software to 


turn the G-code into 
\ instructions for the 


three stepper motors via 
the motor drivers 


thing that I’ve done with it. It 
brings together my passion for 
electronics and for woodworking.” 


The build 


“T’ve made the complete CNC out 
of marine ply, all handcrafted, and 
mounted a DeWalt router to do the 
cutting,” Mark reveals, “using the 
Raspberry Pi 2 as the controller, 
which runs a bit of software called 
CNC Zapmaker, which passes 
the instructions in G-code to an 
Arduino Uno. This runs a version 
of Grbl controller, which has a CNC 
shield connected to it that drives 
the three X Y Z stepper motors.” 
“This is just an overview,” 
admits Mark. “The controller and 
machine took about two months 
to build: mainly evenings.” In that 
time, Mark also had to build the 
physical apparatus of the cutting 
machine - a1000mm long, 500mm 
wide, 700mm high framework, 
with tracks for clamping the wood, 
trapezoidal bars for the stepper 
motors to drive across each axis, 
and a lot of cabling. 
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With 200 steps per revolution 
(on the current setting), the 
motors allow precision control 
of movement. One revolution 
moves the cutting tool 2mm, so 
one step is just 10 micrometres! 

— with one thou (a thousandth of 
an inch), the traditional measure 
of fine tolerances in engineering, 
equalling circa 25 micrometres, 
this is extremely precise for 
woodcutting. Theoretically re- 
gearing the stepper motors could 
improve this again, but that fine a 
level of detail would be lost against 
the size of the grain of the wood. 

The stepper motors — around £12 
each from China — have a power 
of 1070z holding torque; add in 
Mark’s use of trapezoid rods and 
heavy-duty fixing bars, rather than 
the threaded rod and drawer rails 
used in budget CNC home-builds, 
and we have a strongly engineered 
machine that’s built to last. Yet, 
including all the electronics as 
well as the other hardware, the 
build price was around £400. A 
decade ago, you’d find similar 


>STEP-O1 

At the drawing board 

The first task is to work through the design in your 
choice of CAD software, then let it generate the 
G-code needed. FreeCAD users will need a CAM 
plug-in or HeeksCNC. 


>STEP-02 

Grbl 

Mark uses AutoCAD, which enables him to select 
the tool bit used, as well as plan the cutting path. 
The recently open-sourced Blender CAM is one 
possible alternative for this. 


MagPi meets timber 

The Pi creates the Grbl code used by the Arduino, 
which handles putting the router in the correct 
places to turn our 3D design into a sculpted or 
carved piece of wood. 
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Projects 


SHOWCASE 


Fan 
d 


The frame holds 
everything together 


commercial machines costing well 
into five figures — these are great 
times for makers. Indeed some 

of those obsolescent commercial 
CNCs are being repurposed with 
homebrew controllers by those 
without the time to follow Mark’s 
rota roune: 


In control 

In the controller, a touchscreen 
interfaces to the CNC controller, 
running on a Pi 2 with Zapmaker 
software: on screen, the control 
software’s grey, pleasingly 
industrial panel complements the 
electrical box used as a casing. The 
Pi communicates with an Arduino 
Uno board, which uses Grbl to 
control the stepper motors. The 
Grbl handling of the Arduino is quite 
sophisticated — you can send a one- 
line command such as “a circle to 
here, of this diameter,’ and it will 
work out the cuts for you. 

The power supply is a heavy-duty 
24V unit from some LED lights. 12V 
and 5V step-down transformers 
provide power for the LCD screen, 
Raspberry Pi, stepper motors, 
Arduino, and shields. The shield 
controlling the motors can become 
very hot, and so a small fan is used 
to cool it. 


Eagle-eyed readers will have 
spotted the extra board between the 
Arduino and the controller shield — 
this is a buffer board installed after 
the early prototype kept switching 
off: “Someone said you need a 
filter between the Arduino and the 
CNC controller board,” says Mark. 
A filtering board stops current 
bleeding through from the motors 
to the relays for the end stops and 
switching off the device. This has 
fixed the problem: “I’ve checked the 
voltage drop now on the end stops; 
it stays at aconstant 5 volts.” 


Making the cut 

Before use, G-code is needed to give 
the coordinates for cutting. The logo 
in the pictures was converted into 

a black and white image, then into 
vectors — as well as optimising the 
cutting path, and the correct cutting 
head. FreeCAD is used by many 
CNC makers, but needs some form 
of CAM plug-in to generate the 
G-code and the cutting path. 

The G-code is just lines of 
coordinates. The CAD/CAM 
software has the job of generating 
it, together with the cutting path 
that makes the most sense — a CNC 
machine’s version of computing’s 
famous travelling salesman 
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>STEP-03 

Arduino 

An Arduino Uno runs Grbl software to 
accept cutting instructions in G-code and 
turn them into electrical pulses to control 
the stepper motors and position the 
router precisely in three planes. 


>STEP-02 

In the frame 

Hand-cut from 18mm (24°) marine ply, the 
frame rigidly holds the trapezoidal bars, 
stepper motors, and router, as well as 
keeping the work in place with clamps 

in the built-in tracks. 


>STEP-O1 

Stepper motors 

Stepper motors - dividing each 2mm 
revolution of the trapezoidal bars into 200 
steps - position a DeWalt router in the 

X, Y, and Z planes, with an accuracy of 

10 micrometres. 
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problem to find the optimal route 
between multiple destinations. 

Mark is a long-time user of 
AutoCAD. While it’s an expensive 
option for anyone buying just for 
a CNC machine, it readily provides 
everything you need if you’re 
already a user: “On my Mac, I 
design any shape or carving and 
convert the 2D or 3D model into 
G-code, then Wi-Fi it or USB-stick 
it to the Raspberry Pi. Using the 
touchscreen, I start the controller 
up and off it goes.” 


ro] 


Well, not quite: safety features 
are an essential part of any CNC 
machine. After lining up the cutting 
tool to the wood block, locking the 
wood in with retaining bolts set into 
the tracks, and manually correcting 
the height, the safety must be 
clicked on the controller. There’s 
also an emergency stop button 
on the front of the machine’s 
base. Any powered cutting tool 
must be built with ways to quickly 
stop it, just in case of something 
going wrong. 


>STEP-04 
On the Pi 


There are also tripper switches at 
the end of each trapezoidal guiding 
bar, to stop the router should it ever 
be sent to the end of the bar. These 
were what was being tripped by the 
current leak before the buffer board 
was added to the Arduino. 

The controller box has four 
buttons by the screen: on/off, 
panic!, restart, and emergency 
stop. It can cut into a60mm depth 
of wood. As an alternative toa 
complete cut, you can optionally 
set up the controller to leave tabs 


electronics and for woodworking FF 


in, to make it easier to lift out 
pieces together from the bench. 
Looking at The MagPi logo in the 
photo (and on Mark’s YouTube 
channel - bit.ly/thZFUmu), you 
may be able to see the grooves on 
the side, matching different depths 
of cut. This was cut in three passes, 
taking around five minutes, to 
allow for the quality of the router 
bit, which cost only £1.20. Given a 
better bit, the logo could have been 
cut in one pass, taking less than 
a minute-and-a-half. 


>STEP-05 


Raspbian 


Mark tells us he did much of the CNC machine's 
design ad hoc: “I hand-cut the frames, testing out 
sizes as | went.” This is apparently a contrast to 
his usual way of working. “Normally | like to have 
everything carefully thought out from the start.” 

Should he wish to build another, “Now | can 
do a template for it to cut a new version of 
itself." Future plans may include alternatives to 
Zapmaker: “There are other things I'd Like it to do 
with it. | just like to try things my way.” There's also 
the possibility of similar mechanics and controlling 
apparatus for a different head: powering a 3D 
printer, possibly, or to rig up to a Blu-ray laser to 
try as a cutter (suitably shielded, of course). 

“| like to build,” says Mark, which seems to 
sum things up quite well for many in the maker 
movement. Having seen some of Mark's other 
builds - from oak drawers that convert into a Sony 
PS3 racing car controller, to the famous telephone 
box refrigerator - we're sure that whatever follows 
will be an interesting project, as well as something 
extremely well engineered. 


>STEP-06 


Grbl controller 


Put it all together and the screen 
shows the cut to be made, waiting for 
you to hit the Start button after you've 
secured the block of wood safely 

in place. 


Zapmaker's CNC software runs ona 
standard Raspbian install, and the 
zapmaker.org website has full instructions 
for those new to the wonderful world of 
Raspberry Pi, as well as Grbl information. 


Zapmaker's Gbrl controller software was 
originally optimised for a Pentium Ill with 
256MB of RAM, and readily made the 
transition to the Pi Model B, hardly troubling 
the Pi 2 in Mark's CNC controller box. 
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Aspectacular sculpture, 


SeeMore is also a fu 


nctioning 


parallel computer comprising 
256 Raspberry Pi Model Bts 


Each Pi is connected 


servo that moves its arm, and 
therefore panel, outwards in 
proportion to its workload 


Each plastic panel is 


etched with the IP address 


for the Pi mounted u 


toa 


Yi 


pon it 


The articulating arms are 
designed with a double 
linkage to create a fluid 
‘waveform’ movement 


Quick 
Facts 


> 580lb (263kg) 
of high-density 
plastic was 
used in the 
construction of 
SeeMore 


» It comprises 
1,280 moving 
parts and 
7,312 pieces of 
hardware 


» 1,320ft (402m) 
of extruded 
aluminium was 
used to create 
the framework 


» SeeMore's 
construction 
involved 60 
hours of CNC 
machining 
and 80 hours 
of volunteer 
assembly 


» It takes around 
one and half 
days to wire 
it all up, using 
1,536ft (468m) 
of USB cable 
and 2,200ft 
(670m) of 
Ethernet cable 


ae igo a, 
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THE PI-POWERED PARALLEL 
COMPUTING SCULPTURE 


Powered by a cluster of 256 Raspberry Pis, Virginia Tech’s 
stunning kinetic sculpture gives a visual representation 
of how parallel processing works 


tanding nine and a half 

feet tall, the SeeMore 

SCUL OUUME SC Ulin 
Supercomputer suddenly whirrs 
into lite, its ereen translucent 
panels sliding fluidly outwards 
in mesmerising waves across its 
Spiral surface, delivering a physical 
representation of the computations 
being performed. Resembling 
something from a science-fiction 
movie, SeeMore is powered by a 
network of 256 Raspberry Pi Model 
B+s; one is attached to each plastic 
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panel, whose articulating arm 
Swings outwards whenever that 
particular Pi is actively working on 
a parallel computing task. 

The idea for SeeMore originated 
in 2013 when Virginia Tech (vt.edu) 
computer science professor Kirk 
Cameron was working on a 32- 
node Raspberry Pi cluster in his 
lab. Seeking a way to help more 
people understand the concept of 
parallel computing, he approached 
his colleague Sam Blanchard, 
assistant professor of sculpture, 


tone piereale aninteractive aint 
installation for that purpose. Since 
Sam’s main area of interest lies in 
robotic creations, he immediately 
suggested making a kinetic 
sculpture that responds to what’s 
going on inside the computer. 
“LCDs are cool,” explains Sam, 
“but you can really get a visceral 
reaction from people by showing 
them something that is moving... 
and has a presence in a space.” 
Sam tells us that the cylindrical 
design of SeeMore was partially 
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inspired by the classic Cray-1 
supercomputer of the mid to late 
1970S, a time when computers were 
far from being boring black boxes. 
“They had a physical presence, 
almost like a sculpture or a piece of 
furniture,” says Sam. Indeed, the 
Cray-1 even had a bench around it 
so that people in the office could 
sit and have their coffee! While 
SeeMore lacks a seating facility, 

its footprint is proportional to 

that of the Cray-1, although it’s 
almost twice as big and also has an 


The power of parallel 
This transparency of design ties in 
perfectly with the project’s main 
aim of helping the general public 

to visualise how parallel computing 
works and emphasise the important 


work of high-performance computing 


researchers. As Kirk points out, we all 
benefit every day from the advances 
made in large-scale systems that 

are essential to the infrastructures 

of services like Google, Twitter, 

and Dropbox. “Yet, the general 
population that relies on these 


SeeMore was partially inspired by 
the classic Cray-1 supercomputer 
of the mid to late 1970s 


hourglass shape to it. In addition, 
an early design decision was taken 
to deliberately expose all SeeMore’s 
workings, including the combined 
2,736 feet (834m) of wiring, in 
much the same way as the Cray~1. 
“One thing I really appreciated 
about that form was that it 

had this interior space and an 
exterior facade and so it was very 
transparent in the way that you 
could not just literally see through 
it but walk around and see [all the 


wires and workings],” reveals Sam. 
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technologies doesn’t understand 

the importance and the elegance 
innate to what folks like us do. By 
using aesthetics and visualisation, 
my idea was to impart the most basic 
information such as the fact that we 
use lots of devices collectively and 

in parallel to solve problems larger 
than those we can solve with a single 
system. The algorithms you see on 
SeeMore represent synchronous and 
asynchronous communications and 
collaborations common in parallel 
codes and systems.” 


The original panels were replaced with green translucent ones 


for the 2015 World Maker Faire in New York City 
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Each panel 
moves out in 
proportion to its 
Pi's workload 
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When SeeMore was exhibited 
recently at the World Maker Faire 
in New York City, it was set up with 
a local open-source database to 
enable users to search (via a custom 
touchscreen) for points of interest 
around a given subway stop. Kirk 
tells us that multiple steps are 
required to for such a task. “The 
first is to break this problem into 
smaller sub-tasks such as having 
each Pi search part of a very large 
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Taster 


database of points of interest. In 
this example tie Pis im olmeluster 
would be assigned portions of a 
database to search and all of them 
would be given the same subway 
stop as their ‘token’ to use in the 
search. This divide-and-conquer 
approach is acommon algorithm 
used in parallel computing and 
this example is similar to the 
algorithm used in Google search 
and demonstrated on SeeMore.”’ 


Scaling it up 
Having started out with a modest 
budget, the project was gradually 
scaled up via three prototype 
stages, which used first one 
Raspberry Pi, then nine, and then 
30 (see ‘Prototyping process’ 
boxout). Extra funding was 
subsequently provided by the 
National Science Foundation and 
Virginia Tech’s own Institute for 
Creativity, Arts and Technology, 
which enabled it to be scaled up to 
the final 256-node version. 
SeeMore’s mechanisms were 
all custom-made and designed by 
Sam, and their design evolved over 
time. Most notably, the articulating 
arms that move the panel-mounted 
Pis were designed specifically to 
create a more fluid effect. “The 
movement of the Raspberry Pis is 
actually a curve... so it doesn’t just 
flap out, it articulates outward,” 
says Sam. “It has a double linkage 
that some might see as superfluous, 
or overly complex, but I think that 
what you get... is this waveform 
that relates to these ideas of fluidity 
and that springs from what a lot 
of parallel computers are built 
to process: things like weather 
simulation or fluid dynamics.” 
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Also, rather than moving straight 
to its maximum 90-degree outward 
position when triggered, each 
panel moves in proportion to the 
percentage of computing capacity 
being used by the respective 
Raspberry Pi. To achieve this, 
each Pi is linked to its arm’s 
servo via a GPIO pin. While in the 
prototype designs, the servo also 
received its power from the Pi, a 
switch from the original Pi Model 
B to the B+ for SeeMore’s final 
version necessitated that both be 


hours machining those pieces,” 
laughs Sam. He tells us that this 
provided students with many hours 
of milling experience. 

The plastic panels are all laser-cut 
and etched with the IP address of 
the attached Pi in two places, so they 
can be seen whether the panel is flat 
or has moved out. Having started 
out with blue and clear panels, the 
team changed them to a translucent 
ereen for the New York Maker Faire. 
“T like the idea of customising the 
project for where we show it.” 


The logistics of exhibiting 
SeeMore at an event involve it 
being transported 1n six crates 


powered separately. Not wanting 
to overcomplicate the design 

with battery packs or external 
power supplies, Sam ended up 
buying PSUs with two USB ports so 
separate cables could be run to the 
Raspberry Pi and its servo. 

On the software side, Kirk tells us 
that the combination of controlling 
the servos and running a full OS on 
the Pis led to complications. “For 
example, there is a software stack 
or a Series of tools that we typically 
install on top of the operating 
system across the whole cluster. 

In the Pi environment, combining 
this stack with the servo controls 
and synchronising the movement 
of the Pis to running tasks was 
challenging... there is not a lot 

of community software support 
available since this had never been 
done. Thus, we created a lot of 
custom software to make this work 
in a visually compelling way.” 


Custom components 

The arms themselves comprise 

a number of pieces made from 
HDPE (high-density polyethylene) 
plastic, milled out on a ShopBot CNC 
machine. These had bronze bearings 
inserted, all using steel shafts cut by 
the team. “Almost every single piece 
is custom: some people assume 

we bought those off the shelf, but 

I can assure you we spent many 
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The logistics of exhibiting 
SeeMore at an event involve it being 
transported in six crates and then 
assembled at the location. “My 
students and I show up three days 
ahead of time,” says Sam. Once the 
framework’s rings — which are split 
into two for shipping, with Pis still 
attached — are put back together, 
there’s a day and a half of wiring to 
be done. “It’s one guy on the outside 
and one guy on the inside, and then 
you’ re just passing wires to each 
other. It’s actually pretty loose in 
there and I like to keep it that way: 

I like how the wires move on their 
own inside the structure.” While 
routing all the USB power lines 
correctly is a major challenge, Sam 
tells us that getting the Pi network 
connected is less problematic 

since the cables are connected to 

Six 48-port Ethernet switches in 
SeeMore’s base, so it doesn’t matter 
which ports they’re plugged into. 

Although the overall assembly 
process is arduous, the end result 
is certainly spectacular, attracting 
a crowd of visitors at the couple 
of events at which SeeMore has 
appeared so far. Sadly, Sam tells us 
there’s no suitable space at Virginia 
Tech to keep SeeMore in assembled 
form, so it’s currently back in its 
crates, but there are plans to exhibit 
it again in 2016. Watch this space 
for more news. 


Projects 


Before scaling up to the final full-scale version of 
SeeMore, three prototypes were created... 


Prototype 01 

The first basic prototype featured a single Raspberry 
Pi connected to a metal articulating arm powered by 
a servo. This was then given to the computer science 
department to test the software. 


Prototype 02 

With nine Raspberry Pis mounted on a flat framework, 
the team had to figure out how to wire them up to 
avoid any tangling. The computer science department 
created a nine-node parallel computing algorithm. 


Prototype 03 

Scaling things up, 30 Raspberry Pis were mounted on 
transparent HDPE panels, while the articulating arms, 
framework, and wiring system were similar to those 
used in the final full-scale sculpture. 
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Mirror mirror on the wall, what’s 
the weather going to be like today? 
Should I bring an umbrella? 


It's an extra-useful mirror 
as it displays up-to-date 
weather information taken 
from the internet 


It Looks like a mirror, but it’s 
actually a cunning disguise —- 
a monitor, and some two-way 
glass covered by a frame 


» The project 
is made with 
Google Coder 


» It took a week 
to do the frame, 
a few days for 
the code 


» This is Bradley's 
first creative 
Pi project 


» In the past, he 
has used Pis in 
his home Cisco 
networking lab 


» The online 
community 
helped a lot to 
get this to work 
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t?s amazing how the Iron 
Man films have inspired 
people due to the way 
they portrayed almost-attainable 
technology. Watching someone 
look over sunny Malibu while the 
weather info was displayed right 
in front of them was a great visual. 
It’s not exactly brand new, unseen 
technology — cars have been 
projecting HUDS onto windscreens 
for a while now -— but it has never 
been popularised in a major 
blockbuster before. While we 
don’t seem to have quite reached 
the stage of the incredible glass 
tech of Tony Stark’s bedroom just 
yet, apparently we’re close enough 
to get mirrors working in the same 
way, or at least Bradley Melton has 
managed it with his Magic Mirror. 
“It’s called a ‘Magic Mirror’, 
but a more accurate name would 
be a ‘Smart Mirror’,” Bradley tells 
us. “It’s a mirror that displays the 
information you need to know at 
2 OUNCE. eines une wicme, ine 
date, the weather, and of course : 
a compliment!” 7 
It’s not the first mirror of its . t a oS 
type, and Bradley admits that he’s WS = ue RSS 
taken some cues from a previous | lf | had to choose betwee i ener ES : 
project by Michael Teeuw (see more he Fovers a = bate ™ 
details about it on Michael’s blog: 
Magpi.cc/1PzFbWa), taking the 
concept and bringing it down to 
a more beginner level for himself 
so he could learn more about 
web development. 
“Plus, because I know what each 
and every function does and how it 
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would be you | 


Of course, a mirror should 
also be able to reflect your 
image and make sure you're 
looking good 
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works, it makes it easier to fix bugs 
as well as make improvements 
in the future.” 

Rather than use an actual mirror 
and project the data upon it, the 
Magic Mirror uses a widescreen 
monitor that has been put ina 
portrait orientation with an acrylic 
two-way mirror on top. With the 
right lighting and display tweaks, 


>STEP-02 >STEP-03 


“It’s not very complex,” 
Bradley informs us. “ As long as 
you have a little bit of carpentry 
or DIY skill to build the frame 
and have a basic understanding 
of how to program, you should 
be able to build this. I have never 
used JavaScript or CSS before this 
project, and I only had a little bit 
of experience with HTML, but this 


Rather than use an actual mirror 
and project data upon it, the Magic 
Mirror uses a widescreen monitor 


it can be reflective enough to use 
as a mirror while also displaying 
the weather data. The electronics 
are fairly simple: it’s just a Pi with 
HDMI linking to the mirror, a WiFi 
dongle to retrieve online data, and 
a USB cable to the monitor as well, 
which is how it draws its power. 
To finish it off, Bradley built a 
wooden frame to be laid over the 
bezel so that the whole thing was 
camouflaged a bit better. 


webpage is built almost entirely 
inom Javascripuand @Ss. 

At the time of writing, 
the mirror has been running 
for a few weeks without any 
problems. It seems like Bradley 
wants to include some holiday- 
themed extras to it, starting with 
some spooky additions for the 
Halloween just past. We’re hoping 
he will add some jollier ones for 
the Christmas period. 


Above Say ‘Bloody Mary’ three times into the mirror 
on Halloween for a voice-activated fright 
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Turn the system on with a code 
and set a timer, giving you full 
parental control 


= RPIKIDS 


» It took 90 hours 
to build 


» This is Adrian's 
first Pi project 


» Scratch is 
installed to 
encourage the 
kids to code 


e’ve all seen wacky 
parental control methods 
for kids’ entertainment. 
Our favourite is the exercise bike 
that powers a PlayStation, which 
may seem cruel but at least means 
there’s a cut-off point for how 
much they’re able to play. The best 
method is still the simplest: a key 
code and a timer so that the kids 
can then do something other than 
Stare at a screen all day, freeing 
up the TV so you can binge-watch 
the entirety of Once Upon a Time’s 
third series. With the Raspberry Pi 
being a far more powerful option 
for operating an entertainment 
centre, it was only a matter of time 
before an intrepid hacker made the 
ultimate version for their kids. Meet 
RPikids, created by Adrian Atwood. 


» He's adding 
wireless PS2 
controllers 
very soon 


» Adrian has 
more cool Pi 
stuff planned —- 
keep an eye on 
his blog 
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“RPikids is an all-in-one 
kids’ entertainment centre with 
integrated parental control 
features,” Adrian explains. “My 
kids can enjoy 16-bit games, 
watch movies and more, provided 
an adult has granted them 
access by entering a password 
and setting the timer.” 

The RPiKids is a mix of hardware; 
the system itself is powered by 
a Raspberry Pi, handling Kodi, 
Emulation Station and the like 
for the entertainment side. The 
passcode and timer are handled 
by an Arduino Uno using a rotary 
encoder (think bank safe), which 
can be pushed as a button to 
confirm selections. It’s all built into 
a wonderful-looking, steampunky 
case that was handcrafted by 


A standard LCD screen 

is built into this beautiful 
cabinet, and displays 
Kodi or Emulation 
Station from the Pi 


The many USB ports allow for 
controllers and USB storage drives; 
however, media is accessible over 
the network as well 


Not a spin-off Saturday morning cartoon, RPiKids is a new 
entertainment system built for Adrian Atwood’s children 


Adrian himself from wood with 
3D printed detailing. 

There are USB access ports on 
the front for connecting controllers 
and portable media storage, and 
the hardware is visible behind a 
removable clear Perspex panel. 
While it all looks extremely 
impressive, Adrian claims it’s an 
overall ‘intermediate’ level of build. 

“T will say the Raspberry 
Pi configuration was very 
straightforward and a beginner 
can mirror my configuration,” 
he tells us. “Coding the firmware 
for the Arduino parental controls, 
and having the Arduino and Pi 2 
communicate with each other, was 
iitlem@ne comple Tinecaseis mo 
problem if you’re into woodworking 
and auto body repair. I have access 
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The gear that powers 
the centre is all 
visible through this 


Perspex sheet - good 


for maintenance and 
inquisitive minds 


RPiKids is an all-in-one kids’ 


entertainment centre with 
integrated parental control 


tora 2) printer andvaseneutier 
and enjoy CAD modelling, but 
those parts could be contracted 
out or replaced.” 

Although he expected ‘all sorts’ 
of glitches, the system has worked 
extremely well for him and his 
children, requiring only minor 
adjustments to the brightness 
of the ring of NeoPixels used in 
conjunction with the encoder. 

One thing Adrian recommends 
for anyone trying to replicate the 
project is an upgrade to the sound 
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output: “The Pi definitely needed a 
DAC (I?S) sound card because there 
was a lot of hissing and artifacts 
with the onboard sound.” 

The kids have been very much 
enjoying it. Although it’s an 
entertainment centre, he’s also 
programmed an intentional 
security vulnerability into the lock 
mechanism, hoping his kids will 
learn something about security 
systems. We wish them the best 
of luck in figuring out to unlock 
‘unlimited mode’! 


RPIKIDS 


Projects 


ENTERTAINING 
THE KIDS 


>STEP-02 


>STEP-03 
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» Ron used just a 
jigsaw, drill, and 
utility knife 


» The whole 
project cost 
around £60 
to build 


» Ituses a worn 
out battery 
but runs for 
three hours 


» Ron plans to 
add ultrasonic 
and bump 
sensors to 
the Dalek 


» The Dalek 2.0 
will be based 
ona mobility 
scooter 
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The Raspberry Pi acts as 
the brains, and the Dalek 
is remotely controlled via 
a web interface 


The Dalek’s body was 
built from leftover shed 
parts covered in glossy 
black paint 


The base is designed 

to work as a robot 
lawnmower, and the 
Dalek body is placed on 
top for Halloween 


i 
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RASPIMOWER 


Ron Ostafichuk set out to build a robot lawnmower and ended 
up with a fully automated Dalek (you know how it is) 


aleks are the most feared 

race in the universe, so 

what could be more fun 
than building your own Raspberry 
Pi- powered Dalek? 

That’s what developer Ron 
Ostafichuk thought. “I’ve been 
tinkering with the Raspberry Pi 
ever since it came out,” he tells us, 
“and I’ve seen many small robot 
projects, but decided that a big 
robot would be much more fun.” 

The Dalek didn’t start out as 
a Dalek: Ron wanted to builda 
robotic lawnmower. “I have a 
huge lawn and I wanted to show 
my kids that you could builda 
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large robot, using spare parts 
and scraps.” 

The wooden base contains two 
12V motors recycled from a life 
Spent adjusting the seats on cars. 
These motors are connected to 
the big off-road wheels using 
a V-belt system. 

“Once I had the motorised base 
completed, my kids hopped onto it 
and proceeded to ride it around the 
neighbourhood. They loved it, and 
remarked how great it would be to 
ride it around for Halloween. Since 
Iam a pretty big Doctor Who fan, the 
idea that came to me was to turn it 
into a Dalek!” 


For power, Ron is using an old 
12V deep-cycle camper battery. 
“(It] was no longer strong enough 
to use in my camper,” says Ron, 
“{but] it lasted for around three 
hours of continuous operation 
this Halloween.” 

“Tam running the standard 
Raspbian distro on the Pi,” says Ron, 
and the Raspimower Dalek control 
code is written in C++ (available on 
Bitbucket — magpi.cc/1HWNV8j). 

The Dalek is a body that sits on 
top of the Raspimower base. The 
frame was built from 34-inch 
(19mm) chipboard, and the outside 
from 1/4-inch (6mm) sheeting. 
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“This was all left over from building 


a shed,” reveals Ron. One arm is a 
toilet plunger and the other is an 


aluminium pipe wrapped with wire, 


and the whole thing is painted over 
with glossy black paint. 


The old computer speakers 
inside are so loud, they actually 
vibrate the sides of the Dalek 


The Dalek was originally 
controlled with a wireless 
keyboard, but Ron has built a 
web interface to control the 
Raspimower Dalek. Ron has also 
bought an old Zappy mobility 
scooter for S6oCND (around £40) 
and plans to use it to replace the 
12V motors. He explains that 
it's much more powerful and 
mechanically sound. 

“{The Dalek] is nowhere 
near completed and constantly 
changing, as I have lots of plans 
and want to make it autonomous 
so it will actually ‘exterminate’ 
any long blades of grass in my 
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RASPIMOWER DALEK 


>STEP-02 


yard,” jokes Ron. Speaking of 
extermination, no Dalek would 
be complete without its famous 
voice command. “It has some 
old computer speakers inside 


that are very loud; they actually 
After the Dalek has done its 


Halloween duty, the base returns 
to being a robot lawnmower 


vibrate the sides of the Dalek. 

It has about 15 sound clips from 
Doctor Who, but ‘exterminate’ is my 
favourite one! 

“Tt was a huge hit this 
Halloween, and as the kids would 
approach, I would turn on all 
the lights and rotate the robot 
towards them while belting out 
‘exterminate!’ or ‘destroy!’. 
Watching the kids react was so 
much fun; my favourite reaction 
came from a little girl who turned 
to her dad and matter-of-factly 
said, ‘Well, I guess we know 
which house we will never ever 
go to again!’ ” 
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A Raspberry Pi is 

wired up to an L293D 
controller. This controls 
the original motors from 
the remote-control toy 


» The Spy Rover 
works for 
around 40 
minutes 


» At around 
2mph, it won't 
break any 
speed records 


» It took around 
three months 
to build 


» The range 
is limited 
by the WiFi 
connection 


» With port 
forwarding, 
it can be 
controlled over 
the internet 
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Awebcam is connected and 
used to send the video image 
from the Spy Rover to an 
Android phone 


The body of the Spy Rover is 
an old remote-control toy with 
the top removed 


Fancy turning an old toy into a remote-control spy: Lucy Hattersley 
talks to Stratos Botsaris about his Spy Rover project 


ava engineer Stratos 
Botsaris hacked a remote- 
control toy and turned 
it into a far cooler Pi- powered 
Spy Robot. If that wasn’t excting 
enough, he now controls it from 
his Android phone while it bounces 
the video display to the screen. 

A project like this deserves 
further investigation, so we 
caught up with Stratos to ask 
about the Spy Rover. “I did not 
want to build just another moving 
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robot,” he says. “At the same 
time, I was experimenting with 
the video recording capabilities 
of Raspberry Pi. So that was the 
moment that I came up with the 
idea of building a rover that could 
take real-time video. 

“T wanted to use my Android 
programming skills to develop an 
application that could display live 
video to the user.” 

Rather than build a robot from 
scratch, Stratos took apart a Big 


Bargain King Force Excavator. 
With the top half removed, he 
slotted in an original Pi Model B 
hooked up to a breadboard, 
WiFi dongle, and USB webcam. 

An L293D chip controls the 
motors. “The L293D is a motor 
driver integrated circuit that 
can simultaneously control two 
motors in either direction,” says 
Stratos. “If | want to move the 
rover forward, I make both motors 
turn clockwise, and if I wish to get 
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the rover to reverse, I make both 
motors turn anticlockwise. In case 
Ee WOVEN IMeedIS 176 UE mela. 1 
stop the right motor and make the 
left motor turn clockwise, and the 
same logic applies when the rover 
needs to turn left.” 

With the mechanics in place, 
Stratos turned his attention 
to the controller. It made sense 


Icame up with the 1dea of cutting 
a USB cable and joining 1ts power 
cables to those of the UBEC 


to use acontroller with a screen 
so that he could see through 
the webcam. Eventually, he 
decided to build a controller app 
for Android and control the Spy 
Rover directly from a phone. 

“T have developed some Android 
applications in my spare time, 
so implementing an Android 
application for this project was 
not so difficult.” 

As Stratos discovered, streaming 
the video would prove a bigger 
challenge than controlling the Spy 


REMOTE CONTROL SPY ROVER 


Rover. “After a lot of research, I 
found out that I had to use some 
hibraties, written inG@++, inside 
the Android app to accomplish 
my task. Fortunately, I found 
another project that had solved 
this problem, so by using parts 
of the source code, I was able to 
complete the implementation 
of the Android application.” 


Aside from video streaming, 
the hardest part of the project 
was power. “The Raspberry 
Pi requires a constant power 
supply of 5V voltage and up to 
3A current. After some research, 

I decided to buy a UBEC (Universal 
Battery Eliminator Circuit), 

which provides 5V from an input 
of 5.5V-20V and is capable of 
supplying up to 3A. Then | bought 
a battery box of six AA batteries 

to provide enough voltage (9V) 

bo) lave Ula atC, 


HACK YOUR SPY ROVER 
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“The next challenge I faced 
was connecting the UBEC to the 
Raspberry Pi. I had to find a way 
to connect the power output wires 
of the UBEC to the USB comnector. 
Fortunately, I came up with the idea 
of cutting a USB cable and joining 
its two internal power cables to the 
output power cables of the UBEC; 
this was my real eureka moment.” 

Stratos aims to make the next 
project faster. “The plan is to 
transfer the rover to a plastic toy 
car with normal wheels.” 


>STEP-03 


Above The parts 
are wired up using 
a breadboard. 
This enabled the 


Raspberry Pi to 
be tested with the 
L293D controller 
and motors 
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A beacon is attached 
to acollar and placed 
around Bean's neck 


Bean is a greyhound that 
lives with the Redpepper 
marketing agency in 
Nashville, Tennessee 


» The battery in 
a beacon can 
work for up to 
a year 


» Each beacon 
has a unique 
ID number 


» The signal 
strength is 
used to detect 
Bean's distance 


» Ituses 
trilateration, not 
triangulation, to 
detect Bean 


» Sniffur can 
detect Bean 
ina50-metre 
range area 


Raspberry Pi devices are 
placed around the office, 
and the distance between 
each one and Bean is 
used to locate her 


Matt always knows where Bean the dog is, thanks to his 
beacon- powered Sniffur system - by Lucy Hattersley 


e love animals here at 

The MagPi, so when we 

heard about a Raspberry 
Pi dog-tracker called ‘Sniffur’, 
we had to learn more. 

Sniffur uses tracking technology 
called ‘beacons’; these are 
relatively new devices being placed 
in department stores to track the 
precise location of customers. 

Sniffur flips this idea on its 
head, by putting the beacon on 
a moving object and using three 
Raspberry Pis to detect where it 
is. The object in question is Bean, 
an adorable greyhound adopted by 
Redpepper, a marketing agency in 
Nashville, Tennessee. 
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“We're a culture-first company,” 
says Matt Reed, the project’s 
maker. “A lot of us have dogs or 
pets in some form, so part of us 
being happy is knowing our pets 
are happy. It doesn’t hurt that our 
CEO also has two dogs. 

“Bean is absolutely the sweetest 
dog. Very shy, timid, loving. She 
wanders around into people’s 
offices and just stands next to their 
desks waiting for rubs, then just 
wanders on to the next spot.” 

But all dogs like to go out and 
play. “When [greyhounds] do, 
they are very hard to catch because 
they are so fast,” Matt tells us. 
“They are the second-fastest land 


animal after the cheetah: top 
speed 43mph. Greyhounds also 
have a high prey drive; if they see 
a squirrel then it’s ‘bye bye’. 

“The need to know where 
she is at any moment and 
see if she’s close to the front 
doors is the reason Sniffur was 
built,” continues Matt. “We 
have done retail experiments 
using Estimotes (estimote.com) 
and constantly keep a stock 
of beacons available in our lab 
for experimentation. 

“TI grabbed one of the Estimote 
beacons from the lab and zip- 
tied it to Bean’s collar. Usually, 
beacons are attached in stationary 
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physical locations, but Bean is 
now a mobile beacon transmitting 
a polling signal everywhere 

she goes. 

“T put a Bluetooth USB dongle 
into three Raspberry Pis and coded 
them to listen for Bean’s Unique 
Beacon ID,” reveals Matt. 

One value transmitted bya 
beacon is RSSI (received signal 
strength indicator). This is the 


‘Trilateration is the correct 
term, because Im calculating 
distance instead of geometry 


distance of a beacon from the 
antenna. “I’ve referred to it as 
triangulation because everyone 
knows what that means,” says 
Matt, “but I’ve recently learned 
on Hackaday that ‘trilateration’ 
is the correct term, because I’m 
calculating distance instead 
of geometry.” 

Matt built an app for the iPad to 
display Bean’s location. “It’s just 
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SNIFFUR ‘Projects 


BUILDING A 
SNIFFUR SYSTEM 


>STEP-01 


The Estimote beacon transmits a steady ping 


that can be picked up by the Rasbperry Pis 


an HTML, JavaScript and CSS page 
that connects over the local WiFi 
network to the three Raspberry 
Pis,” he explains. 

“T think this could be a fun 
project for anyone looking to >STEP-02 
familiarise themselves with 
beacons. A cheaper version would 
be TO MSS Cine Pil WO Seine save 
a single radius distance from 
that antenna. 


You could also set an antenna by 

an exit and just throw an alarm, 

flash lights or lock the door, 

whenever the roaming beacon 

comes within range. >STEP-03 
“Hmm,” ponders Matt, “that 

is actually not a bad idea. I think 

Sniffur is fun from a visualisation 

standpoint, but from a practical 

standpoint something more 

proactive might be better.” 
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Elevation data fed into Blender 
ensured an accurate representation 
of Mount Kilimanjaro, with 


detailed contours 


With its summit 
5,895m above 
sea level, 
Kilimanjaro 

is Africa's 
highest peak 


Two models 
were created: 
one for Kurt's 
home and 
another for his 
office window 


The scale used 
iS 1:100,000, so 
10mm on the 
model equates 
to 1km 


Kurt's previous 
mountain 
climbs include 
Aconcagua 
and Denali 


He also acted 
as a Mount 
Everest base 
camp manager 
for a major 
2014 expedition 


KURT HUNTER 


Combining decades of experience in high 
tech with a passion for alpine climbing, 
Kurt co-founded Madison Mountaineering 
and also developed his own RainOn web- 
based tracking solution. 

rainon.com 

magpi.cc /2dUhfSP 


Each of the seven LEDs marks 
the position of a camp or the 
summit, and lights up when the 
climber approaches that point 


The Raspberry Pi and 
all the cabling are 
completely enclosed 
within the model, 
which was hollowed 
out after printing 


[ead At the rear of the model are 
cut-outs for the power and 
Ethernet ports, connected to 
the Pi with extension cables 


oo of> 


LOCATION-TRACKING 
MOUNTAIN MODEL 


When Kurt Hunter wanted to create a smart 3D model to show family 
and colleagues his progress while climbing Mount Kilimanjaro, he turned 


to the Raspberry Pi 


n LED lights up on a scale 
model placed on a kitchen 
counter in Washington 
State, USA, to signify that over 
9,000 miles away in Tanzania, Kurt 
Hunter has reached the summit 

of Mount Kilimanjaro. Climbing 
Africa’s highest peak had been a 
long-held ambition for Kurt. “Ever 
since moving to Seattle 20 years ago, 
I would look up at Mount Rainier 
and dream of climbing it,” he tells 
us. “After getting myself in shape in 
2004, I did indeed climb it and got 
hooked on climbing. That year I set 
a goal of climbing Kilimanjaro, but 
never got around to it until [2015].” 
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In preparing for the two-week 
expedition, Kurt set himself another 
challenge. He wanted to combine 
his passion for 3D printing and 
programming in an interesting way, 
to enable his family and co-workers 
to follow along with his climb ina 
fun, visual experience. To this end, 
he set about creating a Raspberry Pi 
2-powered 1:100,000 scale model 
of Kilimanjaro, complete with LEDs 
to mark the spots of all his planned 
camps, along with the summit 
itself. The location data would be 
supplied by a personal GPS locator 
device, via his own RainOn web- 
based tracking solution. 


Model making 

Kurt spent a weekend designing 
the 3D model in the Blender CAD 
program, using accurate elevation 
data for Kilimanjaro gleaned 

from Viewfinder Panoramas 
(magpi.cc/1Sd7psw) — see 
magpi.cc/1JOosv3 for a tutorial on 
the technique — and calculating 
the physical offsets for the surface 
holes required for the LEDs. The 
model needed to be tall enough 

to contain the Raspberry Pi, 
mounted on a removable base 
panel, and include cut-outs for its 
power and Ethernet connections 
(via extension cables). The final 
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150x150mm model was then 3D 
printed using a PrintrBot Metal 
Simple, a process that took 26.5 
hours to complete. 

Once the support scaffolding was 
removed to hollow out the model, 
it was time to wire it up. “The 
biggest labour component was 
soldering up the individual LEDs 
and resistors to the GPIO ribbon 
cable,” reveals Kurt. “The LEDs 
are held in place on the model 
by friction and silicon sealant.” 
While he didn’t encounter any 
major problems getting it working, 
since he’d already made a simple 


solution. “Essentially, the system 
acquires real-time location data 
from a personal locator device, 
such as DeLorme inReach or SPOT, 
for a provisioned ‘trip’ like the 
Kilimanjaro expedition. It then 
provides geofence-based waypoint 
proximity notifications, among 
other features.” 

Each trip is a combination of an 
objective (typically the latitude/ 
longitude of a mountain summit), 
a route (which can include a list 
of waypoints), and a start and end 
date/time. “The system polls the 
services of the personal locator 


Essentially, the system acquires 
real-time location data from 
a personal locator device 


prototype with a breadboard, Kurt 
did discover a difference between 
the GPIO pin assignments on 
Windows IoT Core and Raspbian. 


Trip tracking 

When developing the Pi code 

for the project, Kurt was keen to 
evolve the RainOn Adventure Tech 
(rainon.com) web-based tracking 
system he’d developed for previous 
adventures as a Microsoft Azure 
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manufacturer and retrieves the 
last reported location for each 
device assigned to an active trip. 
That retrieved location is tested 
against the geofence for each of 
the registered set of waypoints 
associated with the trip.” 

The trips and waypoint 
information are created 
in advance. “For example, 
Kilimanjaro using the Machame 
Route that we climbed has six 


each waypoint 


Asecond 


display in Kurt's 
office window 


An LED was 
lit as Kurt reached 


model was put on 
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Above The 3D printed model with scaffolding removed 


Below A breadboard prototype was used to test the system 


68 a The Official Raspberry Pi Projects Book 


>STEP-05 


camps (in fixed locations) and the 
summit, plus the start and end 
locations, so that trip has nine 
associated waypoints, seven of 
which are on my 3D model. All of 
the data is stored in a SQL Server 
database which also supports 


Spatial data, so geofence tests and 
other geospatial calculations are 
super easy.” 


Coding the Pi 


When it came to programming 

the Raspberry Pi to process the 
location data, Kurt ended up using 
the Windows 10 IoT Core operating 
system. As a Senior partner 
engagement manager in his day 
job at Microsoft, Kurt was already 
well versed in Windows and its 
Visual Studio developer tools. Even 
so, he tells us he also developed a 
Python version of the code under 
Raspbian, but found the Windows 
10 IoT Core / Visual Studio route 
much easier. “Three things 

were very attractive about using 
Windows 10 IoT Core: 1) Visual 
Studio is awesome (and familiar), 
2) | could develop in C#, and 3) the 


>STEP-06 


= 


remote debugging/deployment was 
super easy to set up and use.” 
Based largely on Microsoft’s 
Blinky example code 
(magpi.cc/indOkcN), Kurt’s 
program calls the RainOn Azure 
service API every ten minutes to 


The system worked 1n real-time 
and the waypoint LEDs stay lit 
after I had reached that location 


obtain JSON location data. If this 
is within a geofence, set ata 200m 
radius, for one of the camps or 

the summit, the corresponding 
ILJEID: is Ute, 


Testing it out 


To check everything was working 


properly before leaving for 


Tanzania, Kurt used the Postman 


test tool to call on his RainOn 


APIs and simulate data from the 


personal locator device. “T also 
use Google Earth quite a bit to find 
the lat/long of various places and 
measure distances. So I tested 

the system by sending simulated 
locations near the waypoints. 


When I first developed the 


eeofence/waypoint feature, I did 
actually use local locations and 
drive around in my car with the 
device to test it.” 
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When it came to the actual 
Kilimanjaro climb, everything 
worked, although Kurt admits 
he could have used more error 
checking and recovery. “The 
system worked in real-time and 
the waypoint LEDs stay lit after 
I had reached that location. 
However, if the power went out 
then only future waypoints would 
light up, as I didn’t store the 
previously reached waypoints 
ial Le Je), invou Chigl I weyorory une 
history in my web APIs. So, 
sometime between camp three 
and four, this happened to the 
setup I had in my office window, 
but the one at home worked for 
the whole climb.” 


. 
: 


Always another mountain 
Kurt admits that a few shortcuts 
and compromises had to be made 
tne laste imine tis to een thie 
project completed in time for the 
Kilimanjaro trip. Given more time, 
Kurt says he would have liked to use 
the Pi’s HDMI output to provide an 
animated map view and real-time 
data and graph displays. He plans to 
make improvements to the system 
for future expeditions. “I would 
very much like to figure out a way 
to show more discrete climbing 
progress on the model, rather than 
a single LED per day. I’ve thought 
about a number of ways that I’ve 
found to be impractical: light pipe 
projector from an LCD panel, laser, 
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Above Success! 
Kurt and his fellow 
climbers reach 
the summit 


CO lie SERS Oi ulin) IEE) Sie 
I’m looking for an idea!” 

As for the experience of climbing 
Kilimanjaro, Kurt tells us it was 
awesome. “The climb itself takes 
seven days and you hike through 
four climatic zones before reaching 
the summit: rainforest, heather and 
moorland, alpine desert, and finally 
arctic above 5,000m - the summit is 
5,895m. It’s really quite amazing and 
the local staff make the experience 
so enjoyable. Every afternoon, when 
we reached camp, the staff would 
sing and dance with us... The view 
from the summit is spectacular as 
you atrive at sunrise, well above 
the clouds, and can see for miles 
and miles.” 


Above left 
Kilimanjaro rises 
majestically from 
the African plain 
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KRIS TEMMERMAN 


A freelance developer who creates 
interactive displays for museums 
and advertising agencies. He's 


building a robot in his spare time. 
neuroproductions.be 


_ ; The robot will display 
\ — ) an expression on the 
7 screen once a face 
j' | is detected 


A sociable, balancing robot built 
with a Raspberry Pi to power it. 
How tricky is balancing a robot 
via code, though: 


The robot has 
currently taken 
20 days to build 


Its reactions 
to detected 
people still 
need work 


The screen 
displays faces 
when detecting 
people 


Arms are 
planned for 
the robot 


It uses a Pi 
camera for 
the face 
recognition 


here’s a reason a lot of 
robots don’t use two 
wheels or two legs: very 
simply, it’s difficult for them 
to balance. It’s much easier 
and sturdier to be on three (or 
more) wheels or four (or more) 
legs; generally, just having a low 
centre of gravity is a good thing. 
For two wheels in particular, you 
need some way of maintaining 
balance. Usually, this task is left 
up to humans; as Kris Temmerman 
shows us, though, a good bit 
of coding and construction can 
accomplish the same thing. 

“The idea came after 
seeing some social 
robots, like Nao and 
Pepper,” Kris tells us. 
“Technologically they’ re 
ereat, but I think they are 
also kind of boring. Too polite, 
too cute. I wanted to see if Ican 
make a social robot with a little bit 
more character.” 

The robot is self-balancing so 
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eee As more weight is added The whole thing is wireless 
that it can achieve a sna look up top, more balance is and will eventually have a 
to these personal assistant robots, required near the wheels, higher level of autonomy 


hence these stabilisers than it does currently 


and hopefully look a little less weird 
than the robot from Rocky IV in the 
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process. It has facial recognition 
built in so it can detect and react to 
people properly. 

“For me it’s a sandbox — a way 
to try all kinds of hardware and 
software,” Kris explains. Since 
he wanted to do some intensive 
computations, in combination with 


The expressions are admittedly a little 
terrifying at the moment, although they 
do allow the code to be tested 


online. For the face recognition I use 
OpenCV, an open-source computer 
vision library that has the hard parts 
already solved for you.” 

Kris made lot of the body and 
chassis himself with nylon sheets, 
together with some spare motors 
and drivers. There’s an Arduino 


It has facial recognition built 
In so 1t can detect and react 
to people properly 


a display and sound, he opted to use 
a Raspberry Pi 2. “The quad-core 
[CPU] came in really handy. I have 
the face recognition running ina 
separate thread on its own core, so 
the main process that handles the 
graphics, sound, and motion can 
run smooth and uninterrupted. And 
I still have two cores left over for 
future improvements.” 

While Kris says it’s certainly not 
a project for beginners, it’s not as 
hard as it seems. “If you have a 
reasonable amount of programming 
experience, it’s definitely something 
you can make. You can find plenty of 
information about balancing robots 
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layer in the build as well, to aid with 
the balancing. 

That works well and there area 
few online videos you can watch of 
the little robot racing around on its 
two wheels (magpi.cc/1URY7zT). 
The robot still has some work left 
to be done. In particular, Kris is 
looking at mounting a lidar onto it 
so that it can have a better sense of 
its environment, allowing it to move 
around autonomously. 

“This was my first project with a 
Raspberry Pi, but I really like that 
it has a full-blown Linux distro... 
I’m definitely going to use it more 
in the future.” 


BMeuw Oa 


Balancing act 

Once turned on, the robot starts to balance itself to 
stay upright. Much like the Boston Dynamics robot, 
pushing it will cause it to right itself. 


“\ 


>STEP-02 

Remote control 

The robot is not currently fully autonomous, so 
to control it you have to use a wireless keyboard 
connected to the Raspberry Pi. It will maintain 
balance as you drive it around, though. 


29 @p@rasp.. Op > [visonh... | L<Tenmu.. SoMaanWvi a? 4° | 


got ae->0.80 
got ma-»100 o9 
got ma->100.19 
got ma->100.20 
get me >100 39 


got ma >100.49 


>STEP-03 

I see you 

The camera can detect faces. If one appears in its 
line of sight, the robot will look in the direction of 
the face and react to it with noises. 
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As the IR range is mostly heat, 
the sky will be darker than 
usual, while other objects are 
highlighted unusually 


nfrared (IR) cameras are 

traditionally used in low- 

light situations. Typically, 
IR is used in security cameras at 
night, and you can also implant 
an IR camera into your birdhouse 
for a live view of some hatchlings. 
Using it in daytime for ‘normal’ 
photos, though, is something 
quite unusual. However, it’s what 
Krzystof Jankowski decided he 
wanted to do using a Raspberry Pi 
and the Pi NoIR Camera Module. 

“T’ve been a photographer for 

many years and I’ve always wanted 
to take surreal (at least to our eye) 
infrared photos,” Krzystof tells 
us, “but there was no commercial 
camera that can do that easily. Also, 
those cameras for astronomers 


» Itwas tested 
and completed 
ina morning 


» Krzystof likes to 
make different 
portable 
projects using 
Raspberry Pi 


» Krzystof plans 
to makea 
smart wall 
with RSS feeds 
and stats 


» He plans to 
work with 
Arch next 


» The project 
uses a Bt and 
not a Pi 2 or 3 
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were always pricey. Using filters 
was too time-consuming and 
requires using high ISO. 

“When I was ready to buy the 
[Pi] Camera Module, I chose the 
NolIR to test how it works. After 
the few first tests, it turned out it 
works perfectly fine, but using it 
with wires, monitor, keyboard, and 
making photos by command line 
was absolutely not fun. A camera 
needs to be small and have a 
physical button to make photos.” 

Krzystof made a prototype “using 
a lot of duct tape” and went for 
a walk with it. It worked as he’d 
hoped, so he began work on a more 
robust and easier-to-use version. 

“For me it was very easy as | 
know Linux, programming, and 


“44 


4 ATM.) \ Li: Vag 
i it 2 ON B fi¥ PN 

iieigy La. kh 5 j 

a a RIT ONG AY 


Take surreal, IR photos during 
the daytime for a slightly 
different look at the world 
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It works roughly like a normal 
camera — just point and shoot 
to take a photo! 
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Never mind a portable Raspberry Pi camera - how about a portable 
Pi IR camera for taking stunning and unique shots: 


soldering,” he explains. “I think 
that even for newbies it will still 

be easy. The whole thing is fairly 
basic to make yourself: connect 
camera, solder button and LED on, 
put wires to proper GPIO ports, and 
download my script and installa 
few required packages.” 

His custom script is what makes 
it possible, and is downloadable 
from GitHub (magpi.cc/1K2PRgi). 
It’s only 23 lines long, but it has 
some tweaks to the way photos are 
taken to get them to look the way 
they do, and to optimise the speed 
as well, according to Krzystotf: 

“There’s a small lag like in early 
digital cameras. For landscape 
photography it’s absolutely 
acceptable, though. The only 
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Glare produces amazing effects when delving beyond the range of visible light into IR 


downfall is the booting time: as 

it boots the whole of Raspbian, it 

takes 30-40 seconds. However, it 

can work for hours on my power 

bank without shutting down.” 
Right now, the camera is 

a little simple, and upgrades 

are planned for it eventually. 

Software-wise, Krzystof wants 

a software shutdown to prevent 

data corruption, but he also 

wants to add a small OLED screen 


>STEP-01 


Boot process 


There's no switch just yet, so plugging 
in the portable battery turns it on. This 
boots Raspbian on the Pi, and an LED 
turns on and then off once the camera is 


ready to go. 
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for a live preview and settings. 
These settings would then be 
changed with additional switches 
on the build. 

Krzystof has done many little Pi 
projects himself and doesn’t plan 
to stop here: “I encourage people 
to experiment with Raspberry Pi 
— each project is an opportunity 
to learn something new. And 
it’s always a lot of fun to make 
something yourself.” 


>STEP-02 
Take a photo 


turns the LED off. 


Like with any camera, you just need to 
press the shutter button. This one activates 
the Python script to turn the LED on, set 
the camera up, and take the photo. It then 


The mark two rig has a shutter button and LED to let you know 
when it’s ready, although a preview screen will be added 
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>STEP-03 

Get the photo 

You could grab the photo off the SD 
card manually. However, it’s set up to 
be retrieved using SFTP over WiFi as 
well, for quick access. 
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A Raspberry Pi-powered 
smart display rises out of 


the desk 


An LED light strip is 
programmed to change 
colour and send alerts 


to the desk user 


The entire build 
took about 
18 weeks 


Frederick 
divided the 
project into 
sub-tasks to 
stay motivated 


The monitor 
lift is a drawer 
mechanism 
turned 
sideways 


The time it 
takes the 
screen to rise 
matches the 
Pi's boot time 


A USB sound 
card is used to 
power the built- 
in speakers 


Frederick is an electronics hobbyist 
and software test and integration 
engineer. One of his recent projects 
won Element 14's ‘Forget Me Not’ 
challenge. 
frederickvandenbosch.be 


Touch controls are 
hidden in the bottom- 
right of the table. 
Tapping them toggles 
desk features on and off 


Make any desk job exciting with this futuristic PiDesk: a touch-controlled 
table with lights, sound, and a computer that rises from the surface 


so one hobbyist, Frederick 
Vanderbosch, decided to 
build this futuristic workstation. 
Complete with a touch surface, 
speakers, and a motorised display 
that rises out of the table, the 
PiDesk is one of the cleverest 
projects we’ve come across. 

“The build was part of a design 
challenge,” says Frederick. 
The Seiski YourPi compenition 
was launched by the Raspberry 
Pi Foundation and Element14 
to inspire inventors to build 
Smarter homes. 

“PiDesk is an attempt at making 
a Space-saving, futuristic-looking 
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obody wants a boring desk, 


desk,” Frederick explains. “It can 
change from a regular desk toa 
computer workstation and back at 
the touch of a finger.” 

The idea for the project came 
when he was running out of space 
in his workplace. “By combining 
a computer workstation and desk 
in one, I would be able to get extra 
Space to work when the computer 
was hidden inside the desk. For 
the project’s futuristic accents, I 
was inspired by the Tron movies, 
on which I based the light patterns 
of the desk.” 

At first glance, it looks like 
a normal desk. As soon as the 
user places their hand above a 


specific area, however, a desktop 
computer is powered on and starts 
rising out of the desk. This action 
is accompanied by visual and 
audio effects. 

“Two Raspberry Pis are involved 
in the project,” says Frederick. One 
serves as the brains of the desk; 
the second is a built-in desktop 
computer. As well as two Raspberry 
Pi units, the table contains a broad 
range of components. 

The desk itself is from Ikea. 

“It’s one of the cheaper models, 
which have the advantage of being 
hollow,” reveals Frederick. 

“T started by drawing some 
Shapes on the desk to work out 
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where I would perform the cuts and 
embed the electronics. 

“Then the surface was recreated 
using two layers. The first layer 
was paper, which is used to diffuse 
the light and hide all the cuts and 
embedded electronics. The second 
layer is a large sheet of transparent 
Plexiglass, giving the desk a new 
and shiny surface.” 

Touch controls are embedded 
into the surface using a 
combination of conductive paint 


and copper tape. The paint creates 
touch-sensitive pads, while 

the tape makes a connection 

to the Raspberry Pi. 

One neat feature you might miss 
is the built-in wireless charger. 
This is a “little bonus feature | 
had in mind,” says Frederick. 

The Magic Lamp turns on when it 
is placed in the right spot. “The 
wireless charger is embedded in 
the desk, and when the lamp is 
moved on top of it, the lamp is 


powered.” The light consists of 
the wireless charger receiver, a 
microcontroller board, and a ring 
of Adafruit NeoPixels. 

If you’re thinking of building a 
similar project, then planning is 
vital. “Plan ahead and think things 
through,” advises Frederick. “Break 
down the project into smaller, more 
manageable projects. There’s a lot 
to learn by building a project like 
this because so many different 
components are involved.” 


The 
built-in LED strip 
and Magic Lamp 
are especially 
effective 
in low light 


The finished 
productisa 
usable desk witha 
display that can be 
lowered to provide 
more surface area 
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feature 


Sri 


THE CREAT 
SPOOK-OFF 


Get a look at these Raspberry 
Pi Halloween projects that 
are absolutely to die for... 


ather round, ghouls and 

girls, it’s that time of the 

year again when scary rules 
supreme. Perhaps you’re planning 
on dressing up to go trick-or- 
treating or marathoning a ghastly 
amount of horror films, but we’ve 
found some people who are deep 
in their lairs experimenting with a 
Raspberry Pi to create the spookiest 
projects the world has ever seen. 

We’ve hunted down the most 

horrifying and wicked projects 
for your reading pleasure, but 
don’t worry, the only dark art 
at work here is the odd bit of C 
programming. Beware, read any 
further and you’ll be doomed to 
be inspired by these seven unholy 
projects... and have to read many 
more awful puns. 
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RASPBERRY PI 


“HAUNTED 
HOUSE 


Enter if you dare to the abode 
with home scare-tomation 


Data centre manager, father, 
part-time Count Dracula 
magpi.cc/2dqEMrU 


It’s late. The night grows dark and 
you’re near the end of your trick- 
or-treat run — but what’s this? A 
house you’ve never seen before on 
your road. Eager for more sweets, 
you make your way to the door. 

A haunted house sign greets you, 
but you think it merely decoration. 
Approaching the door, you press 
the doorbell - only for glass to 
break and the light to go out. A door 
creaks, the sign you had dismissed 
flashes, and you hear screams as 
the lights come back on. Startled, 
you look to your right and realise 


COMPONENTS LIST 


monsters are partying in the garage 
next to you, celebrating another 
victim in their night of ghastly fun. 

“T had been trying to think of 
something fun to do for Halloween 
and the Raspberry Pi was an 
obvious choice,” the owner of this 
nightmarish house, Stewart, tells 
us. “I’d recently built a circuit for 
home automation using remote- 
control sockets and had the idea of 
using that to turn lights on and off 
automatically. I also spent some 
time looking around at shops to see 
what other Halloween props I could 
add to the project.” 

The system is deceptively simple, 
although there’s a lot of different 
components to it. A dedicated 
doorbell is hooked up to a PiFace 
board that interacts directly with 
the Raspberry Pi and some Python 
code. Stewart chose the PiFace for 
this, instead of wiring up directly 
to the Raspberry Pi’s GPIO pins, 
to make sure he didn’t send any 
unwanted signals through the 
GPIO port — although with the right 
amount of research and careful 
wiring on a breadboard, you could 
do this without the PiFace. The 
PiFace directly controls the LEDs on 
a jack-o’-lantern and the haunted 
house sign, while the porch lights 
and the monster party lights are 
controlled by a wireless home- 
automation remote control that he 
directly soldered into. 


> PiFace 


> Wi-Fi dongle (used during 
configuration and testing) 


> 2x Reed relays (HE751A0510) - one for 
the on button, the other for off 


> 2x LEDs 
> 2x AA batteries with holder 
> Doorbell 


> Remote control socket 
with spare remote 


> Plastic light-up pumpkin lantern 
(with test button) 


> Plastic haunted house sign 


> Waterproof box (or lots of wire 
to allow the Raspberry Pi 
to be installed indoors) 


> Speakers (with amplifier) 
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Above Surely it can't 
really be haunted... 
can it? 


“They are not designed to be 
used that way,” Stewart mentions. 
“The solder joints were not very 
reliable and whilst they lasted for 
Halloween, they eventually came 
loose. Since I made the project, 
Energenie have released a Pi- 
mote Raspberry Pi board for their 
remote-control sockets, which is 
easier to use than having to solder 
onto the remote-control buttons.” 

Speakers play the appropriate 
sounds and music as dictated 
by the code, and the system is 
waterproofed as, well... Stewart 
lives in England. The results? 

“T just managed to finish it in 
time for Halloween. We had friends 
coming over for our children’s 
Halloween party who said they 
liked it, and the trick-or-treaters 
were certainly surprised by it. 
There was one young girl who was 
a little scared by it, but most 
thought it was fun rather 
than scary.” 


Below A simple box 
contains the Pi and 
all the electronics 
so that it’s kept 
waterproof 
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SOCRATIVE 


A philosophical zombie, ora 
frightening, brain-munching head: 


The inside of 
the zombie is a less 
creepy affair, as you 

can see the parts 
that make it work 


DAN ALDRED 


Lead schoolteacher for Computing 
At School, raiser of the dead 
magpi.cc /2dqFmWC 


Out late at night, you should have 
known better than to enter the 
strange shed, but it was about to 
rain and you needed the shelter. 

A sense of unease comes over you 
as the door closes behind you. It’s 
probably just because it’s a bit of 

a creepy atmosphere. The winds 
begin to howl outside, but wait - 
that’s not a howl, it’s more of a 
gurgling groan. And it’s coming 
from inside the shed with you. As 
you turn to confront the noise, you 
see an eerie glow from the corner 
of your eye. You fumble for your 
phone and turn the torchlight on 
to see the source of the noise and 
light... only to find an animated, 
undead head hungry for your flesh. 
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It's gruesome, 
even inthe light 
of day 


Luckily, it’s just a sculpture from 
a school project, but you get the 
picture. Its creator Dan Aldred tells 
us how he came up with sucha 
horrifying idea: 

“T wanted to create a Halloween 
hack that would scare people. 
Sheds are scary in the dark, but 
even more with a talking zombie 
head! I also wanted to create a 
interesting head that would ask 
my students questions related 
to their learning.” 

We assume they learnt the true 
meaning of fear alongside their 
new-found coding and soldering 
skills. The head is one of the 
few projects in this feature that 
makes use of sensors to know 
when someone is approaching it. 
In this case, a PIR motion sensor 
detects changes in temperature 
that correspond to a warm body 
entering its field of view. This 
means it unfortunately would not 
be able to sense its fellow undead. 
The sensor is placed in the mouth 
and controls a Python script which 


also hooks into LEDs and a speaker 
to complete the effect. 

If you plan to replicate this 
project, Dan recommends a 
Raspberry Pi A+ due to its small 
size, and to create a cron job 
to start the program once the 
Raspberry Pi is powered up. How 
did it fare on the night? 

“T had it in the classroom, it got 
dark about 4pm, and the students 
were very intrigued and excited,” 
Dan tells us. “Then I moved it to 
my shed for the 31st and when the 
trick-or-treaters came around, 
they went in the shed and were 
scared. It made them jump; they 
really liked the zombie head.” 


CONJURE UP YOUR OWN VERSION 


Zombie head 
PIR infrared motion sensor 
LEDs 


Speakers 
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PUMPKIN PI 


Usually a delicious dish, can you 


stomach this version? 


Software developer for element14 
community, gourd sorcerer 
bit.ly/1ilW2te 


Carved pumpkins and jack-o’- 
lanterns are a big Halloween 
tradition in many countries. Thanks 
to the internet, there’s been an 
explosion in people wanting to 
make their own custom pumpkins 
to show off, which are a bit more 
than just a pair of eyes and spooky 
erin. These days, you can print off 
pumpkin carving patterns for just 
about anything, and it’s a great way 
to do something a little creative 
with some flesh left over to maybe 
make a delicious soup or dessert. 

Carving a pumpkin isn’t the only 
way to express yourself, however. 
To truly create a ‘hack-o’-lantern’, 
we need to add some electronics to 
its innards and dial up the spook- 
factor. That’s exactly what Drew 
did with his Pumpkin Pi for the 
elementi4 community. Some of the 
projects he creates are inspired by 
upcoming holidays, and in this case 
Halloween was approaching. 

The whole system is fairly simple: 
by activating a preset script from a 
web interface on his computer, the 
lights start rhythmically changing 
colour (check out the YouTube video 
to properly see it in action: 
youtu.be/lIv8H7WPfQw). The 
interface is mounted on the Pi and 
if you use his program for such 
a project, you can have multiple 
sounds and light sequences 
activating within the pumpkin. 

The construction of the Pumpkin 
Pi requires a little more than just 
pressing a button, though. Taking 
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Above Anormal pumpkin, or a lost soul trapped in produce? 


a pre-carved pumpkin (you could 
carve one yourself), Drew then 
lined it with a large plastic food 
bag to make sure the electronics 
inside didn’t get too damp from the 
pumpkin’s moisture. A carving on 
the rear was uSed to pass the power 
cables through, and the breadboard 
with all the LEDs and such on was 
placed on the Raspberry Pi to save 
space. He also put on chopped-up 
drinking straws to diffuse the light 
better throughout the pumpkin. 

A speaker is attached and the 
pumpkin is done and ready for 
testing. If you want to make it a 
little more permanent, you can 
make use of a Pi Plate to solder the 
circuit and then mount it onto the 
Raspberry Pi. 

The Pumpkin Pi is simple, but 
well thought out and put together. 
If you’re going to be inspired by any 
of these Halloween projects, we’d 
recommend starting out with this 
one just to get the feel of creating a 
creepy contraption for your window 
or porch. 


Above All you need to hack your pumpkin are some LEDs 
and some straws, apparently 


COMPONENTS LIST 


> Acarved pumpkin 
> Adafruit Pi Plate 

> Adafruit Pi Box 

> LEDs 


> Resistors and transistors 


BG 


Above left 


Significantly less 
scary with the lights 
on,-nevertheless 
you can see the 
motion sensors 
mounted on crates 
that make it work 


Above right 
Who's at the door? 
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AND SCARY PORCH 


Don’t get too close to this door if you value your sanity 


Electrical engineer, writer, 
crafter of cursed objects 
bit.ly/1p6VQpw 


You are entering the vicinity of an 
area adjacent to a location. The 
kind of place where there might be 
a monster, or some kind of weird 
mirror. These are just examples; 

it could also be something much 
better. Prepare to enter... 

The Scary Door. 

Or not in this case, as this is 
not areal door. Or a Twilight Zone 
parody. While the Haunted House 
we started off this feature with 
shows the entrance to a spooky 
residence, this kind of project is 
what you might find inside as you 


COMPONENTS LIST 


> Too many to list here! Check out the 
link in the profile to find out what 
nearly $800 or more can get you in 
terms of spooky 
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wander around. It’s a peculiar 
metal door, with a window you 
can see through. A knocking 
sound is coming from behind it; 
perhaps someone is lost? As you 
get closer, you see through the 
window a normal-looking lounge. 
You can’t see anyone, but the 
knocking is still there and as you 
reach for the handle, a monstrous 
face appears. 

Cabe’s idea was to create a 
modern haunted house effect 
on the cheap that was different 
every time you Saw it. As well as 
the pop-up scares, there’s ghosts 
and monsters flying around in 
the ‘window’ (actually an LCD 
screen), and the scares and sounds 
you can create are as many as you 
can imagine. The knocking sound 
comes from pistons smashing 
against the door. 

As well as the door, Cabe 
has previously created a Scary 
Porch, which he describes as 
“Can] exploration of my idea of 
consuming someone with light 
and sound, to the point where 
they wanted to run away.” Unlike 


our Haunted House project from 
earlier, which was doorbell- 
activated, the porch could sense 
how far away you were from the 
door. As you started to approach, 
it would start playing creepy 
sounds and slowly turn on some 
bright red lights. As you got closer 
to the door, the louder the sounds 
became and the brighter the 
lights got, until screams and roars 
began playing when you were in 
knocking range. 

“The Scary Porch was only 
set up in my shop,” Cabe explains 
to us. “But, people did see it and 
did what I thought... they wanted 
to get away from the sound.” 

Both are quite elaborate 
projects and if you plan to make 
anything similar yourself, Cabe 
advises you exercise extreme 
caution unless you want to 
make yourself the centre of your 
Halloween display. This year he’s 
toning it down a bit: “I plan to... 
make a wooded path, or [the] 
front yard a bit more scary.” 

At Cabe’s house, we’re sure it’ ll 
be more than just a bit scary. 
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THROUGH THE 


Take the scares around with you thanks 
to this gruesomely interactive costume 


LUIS MARTIN 


Maker, R&D engineer, 
major trauma victim 
bit.ly/1KNZWot 


Scary pumpkins, doors, and houses 
are one thing, but a good scary 
costume is a big part of Halloween. 
While you can’t beat the classics of 
vampires and witches and zombies, 
more imaginative and horrific 
costumes are popping up every 
year. Luis Martin took his costume 
to a new level by adding a Pi and 
some clever coding to make it look 
like he’d been shot right through 
his stomach, something he’d seen 
on The Walking Dead. 

It’s actually quite a simple 
and ingenious design. Using a 
Raspberry Pi as its main core, 
Luis took a Pi Camera Module and 
a 7-inch screen and had a live 
feed from the camera play onto 
the screen. By having the Pi and 
camera on his back, he was able 
to relay the live feed to the screen 
that was showing through his 
shirt, giving the illusion that there 


CONJURE UP YOUR OWN VERSION 


Pi Camera Module 

7-inch touchscreen 

HDMI cable 

GoPro chest mount harness 


Portable battery 
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was indeed a hole in his stomach. 
Scary indeed — just don’t ask him 
to turn around to ruin the effect. 

It also involves a bit more than 
electronics, though: a later border 
was created around the edge of the 
screen to simulate the gruesome 
look of flesh to better create the 
effect through his clothes. With 
skin-tone paint added along with 
blood and detailing to get the right 
effect, he also cut up an old T-shirt 
and stained it with fake blood. 
“You have to be eager to stain your 


Is there 
anything more 
indicative of 
modern culture 
than this image? 


hands,” Luis tells us. “Especially You don't have 
blood. The more blood in a zombie oP eee oe 
ir makes the picture 
costume, the more realistic!” look a bit better 
With the shirt ready, Luis took a 
; The screen's 
GoPro harness se had it hold the fecayeerieredds 
screen down to his stomach, as well to the effect 


as using it to attach the camera to 
the correct spot on his back for the 
illusion to work. This is then simply 
connected to the screen via the 
HDMI port on the Raspberry Pi - 
switch it on and you’re ready to go! 

It certainly sounds gruesome, and 
you’d think seeing a zombie walk 
around with a hole in his stomach 
would make everyone scream and 
run away. “Everyone wanted a 
picture through the hole, like some 
kind of blood-coated selfie°” 

Kids these days, eh? You put a 
hole in your stomach and they’re 
not even scared. 
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~yOur bones and help out the local food bank 


Solution architect, systems specialist, 
and srtist respectively, purveyors of 
haunted numbers 
on.fb.me/2z0uScjv 


yy, 
A/4A 9 
yy/// Scaring people as they come to 
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the door is big business in spooks, 
it seems. We’ve seen porches, 
doors, and monster parties that 
give at least Some warning or 

try to build a scary atmosphere, 
but the HalloweenPi is taking 

the jump-scare approach over 
building suspense. 

To understand HalloweenPi, we 
need to learn about the history 
of Halloween at 3. A yearly 
tradition from the people at 3 


display, Chris Kyte had a bit of 


costumes, and all the other 


Rieanpetis AU Michelle Court, a display of their a brainstorm: trappings of a Halloween-themed 
atworkonthis scariest Halloween-themed ideas “We were considering how display. This new addition will 
ho ears is created to wow (and maybe to draw in a few more trick-or- have a motion-controller prop 
forthebigday frighten) trick-or-treaters or treaters to our haunt. We had attached to it that will spring up 
passers-by. Constantly trying to decided to start collecting canned and scare people as they arrive for 
empresa co figure out a way to make each food donations for our local food Halloween at 3. 
3 Michelle Court? year better by adding to the bank when I remembered the “The HalloweenPi Controlled 
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Raspberry Pi B+ I had received as 
a birthday present earlier in the 
year. I started to wonder if I could 
build a pneumatic prop or two in 
order to ‘up our game’.” 
Currently, the massive tunnel 
houses a laboratory of rainbow- 
coloured mixtures in beakers 
and test tubes that react to 
black light, a projected puppet 
that compliments kids on their 


COMPONENTS LIST 


> 4-channel relay board 
> 2x PIR sensors 


> Wireless key fob to arm 
and disarm the prop 


> A pneumatic cylinder 
> 12V pneumatic solenoid 


>12V amplifier 


Pneumatic Prop will be a really 
spooky piece,” says Chris. “It will 
act aS an ambassador to the haunt, 
reacting to the people who walk by: 
the prop will spread its wings wide 
and will scream a mighty scream! 
The way we’ve designed the props 
and pneumatics means that they 
are modular. They don’t have to 
remain the same each year!” 

The frights are for a good cause, 
though, as Hallowen at 3 takes 
donations for the local food bank. 
“The extra excitement generated 
by the pneumatic props should 
make a big difference to the 
number of people that show up. 
Hopefully, we’ll see an increase in 
food donations as well.” 

We question how such an 
endeavour can be truly evil in 
the Halloween spirit with sucha 
wonderful result, but we’lI let it 
Slide this time. 
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Featured in this very magazine, 
this spooky skull comes alive 


a’ 


We won’t spoil the surprise, 
but it involves a lot of soldering 
and tweaking as you install 
several servos and motors to 


MIKE COOK 


Writer, bone wizard 
magpi.cc /1NqJnTz 


Zombie head? Too much flesh. 
Meet Mulder the skull, a very 
interactive head that you can 
control to scare the living daylights 


out of anyone who makes the 
mistake of passing by. With full 
control over his jaw, neck, and 
eyes, he can move around to watch 
anybody. Not only that, but you can 
light him up in a variety of colours 
and have him give out deadly 
screams or creepy owl hoots. 
Mulder was made by Mike Cook 
as part of the Pi Bakery, and 
featured as a project you can create 
in issue 38 of The MagPi - head to 


articulate the eyes and jaw, along 
with several lights, a speaker 
system, and a way to control the 
neck. It’s all controlled from an 
interface written in Python, the 
code listing and files from which 
are available in the tutorial. 

We suggest you put a hidden 
camera near the skull so you can 
track trick-or-treaters as they 
approach your door. That’s sure 
to scare them off, leaving more 


magpi.cc to get started. chocolate for you. 


) . Control Mulder In still images, Mulder 
LIGHTS mevement with these simplish looks quite tame and funny. 
jaw keyboard controls In real Life, it's a bit more scary 
o - Open 
Eyes Nose CI d 
p - Close RESOURCES AND INSPIRATION 
mo? Eyes 
| te earn Not sure what to make with your Raspberry Pi for 
Mie < Fert Halloween? Over the month of October, all the tech 
mi 3 - Right news sites will be inundated with Halloween-based 
a t b Rich stories, so keep an eye on them. Otherwise, you can 
& n 4 'g ee q head over to the Raspberry Pi tag of the Adafruit | 
B m eer Learning System (bit.ly/1iroRHO), where you can | 
get many great ideas for projects, along with the / \ 
6 - Right ( 
Right Eye element14 community blogs and the Raspberry Pi wile 
Left eye Foundation’s blog. Be inspired to be spooky! Ni WLS 
[| 7 - Forward AY V 
mou 8 - Left ~ a 


SHOW US YOUR PROJECTS! 


9 - Right 
Neck 

Forward Are you doing something spooky for Halloween? LAR \ 
' Send us a picture or video to the MagPi OLY \ 1 
Twitter account (@TheMagP1) or email us at Py! 
magpi@raspberrypi.org and we'll include the best 
ones in our Community section next month! You 
should aim to be abs-ghoul-utely terrifying, but 
even a quite spooky will be good enough. 


Cranium 


Nudge | Nudge 
Stop 
< — Full left 
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> - Full right 
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feature | YOUR Pl ZERO PROJECTS 
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7. E R 4 PROJECTS 


SO FAR 


It took no time at all for people to start putting their brand 
new Pi Zero to work to power smaller and cooler projects 


ell, the launch of the Raspberry Pi Zero was 
exciting, wasn’t it? We sold out of all our 
copies and had to do a second print run, 
meaning there’s a lot of Raspberry Pi Zeros out there 
already for people to start using in projects. Within 
days, people had done some incredible things: new 
hacks, updated hacks, proofs of concept... There was a 
lot of excellent stuff flying around. You could spend a 
good couple of hours going back through the #pizero 
hashtag for them all, but here’s some of the best ones 
that we found while writing the magazine. 
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YOUR PI ZERO PROJECTS | Feature 


XBOX 


CONTROLLER 


>| ZERO ee 


Bring new meaning to Xbox Media 4: ie faa 
Centre by playing Doom built ey oat 
into a controller 


here are many colloquial names for the original 
controller for the first Xbox. The Duke. The 
Bear. The Fire Hazard. Its size is attributed to 
the urban legend of being ergonomic for ‘big American 
hands’; thanks to its size, however, it ended up being 
pretty perfect for Terence Eden’s project. 

“T wanted to play retro games on my TV,” Terence 
tells us. “But I didn’t want to buy yet another box 
to sit under there. I also didn’t want to have to faff 
about with anything too complicated - wouldn’t it be 
ereat, I thought, if I could fit an entire games console 
inside a controller? 

Similar to our project idea (which ultimately resulted 
in a full tutorial you can find in this book), Terence 


“ IT wanted to play retro 


games on my I'V - 


thought originally about using the iconic NES controller. 
However, his wife pointed out that the larger Xbox 
controller would be perfect for what he had planned. 

“So, this project was about stuffing a Pi inside a 
controller and using it to play Doom!” 

Apparently it was a tight fit even for the Raspberry Pi 
Zero, meaning that some of the interior of the controller 
housing had to be shaved off to squeeze it in. “It’s great 
that all the ports are along one side; that makes fitting it 
into tight spots much easier,” Terence adds. 

The component list was nothing fancy: just the 
standard cables needed to make the Zero work and the 
various assortment of tools needed. STIPE A NIN JEN 

Like everyone else, Terence has been inspired and is Patitiiia etal ty ste 
thinking how else he can make use of the Zero. “I’m PEI a 
curious as to whether it makes sense to use it as a door qy 
and window sensor. A Pi Zero is cheaper than a Z-Wave 
sensor so, as long as I can run power to it, Ican place one 
on every door and window at home.” 
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ENERGY 
| MONITOR 


TREVAIL The Internet of Things comes 
techewiorer tO the Zero with an energy 
clapalitiie consumption monitor 


Vv he project uses the Pi Zero as a tiny wee hub 
T to connect my electronic devices at home 
to potentially anything,” says Laura Trevail 
about the Pi Zero energy monitor. “It measures the 
device’s energy consumption and publishes that data 
Ps . live, where it can be found and interacted with by 
DANIELLE Things elsewhere... While I’m brewing up [a drink], 


GRAYSTON I can turn my kettle into something else somewhere = 
Oho re completely different if I like, someone else can join : 
developer me when I’m having a cuppa if they like, or use my 

twitter.com/ inferred coffee consumption data (or whatever else 

Bladepanthera 


Iam sharing) to drive their own story in ways I may 
never have imagined.” 

So, a typical IoT device with a million uses from a simple concept! 
Apparently, Laura and Danielle spent the morning scouring two counties 
looking for a copy of The MagPi, and were surprised by how small the Pi 
Zero was when they finally got their hands on one. 

The project makes use of Energenie, specifically an Energenie two- 
way PiMote and an Energenie MiHome monitor that uses David Whale’s 


pyenergenie library (magpi.cc/1jKpQ8L). 
a LAPTOP — ZER@ EDITION 
SS a, A classic case for the Pi gets a 


revamp, thanks to the new size 
PETER and spec of the Raspberry Pi Zero 
HOWKINS 


ego cases have been a major part of Raspberry 

Software ce : : : 
engineer _ : \ ak L Pi since it very first launched —- especially when 
marutan.net scaly pas , PE | there was very little available in the way of cases 
) , : at the very start. Taking that to its logical conclusion in 
a very short time, a Lego Pi- powered laptop was created, 
and everyone loved it. 

“Tt’s a small portable Raspberry Pi system, ideal 
for carrying to events without having to carry around 
a separate monitor and keyboard,” its creator Peter 
Howkins tells us. “It combines two of my hobbies: 
Raspberry Pi and Lego. This is the third variation of my 
laptop; it started using an original Model B, then I rebuilt 
it to fit the B+ and Pi 2, and now it’s using the Pi Zero.” 

Peter could not believe the price of the Pi Zero when he 
found out about it, but it really does drive down the cost 
of the overall Lego laptop build. It contains converters, 
hacked USB ports, a screen, a USB power pack, mini 
keyboard, cables, and an awful lot of Lego. 
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A great little robot that really shows off 
how versatile the Pi Zero really is 


MARK 
Sih’ CANTRILL 
| Electronics design 


engineer, Maker 
astro-designs.com 


n the last issue, we had an excellent 3D-printed 
Pi Zero robot, as made by Richard Hayler 
(magpi.cc/1lLmeoi). We didn’t think we’d start 
seeing more robots until a few weeks down the line, but 
only a few days later, Mark’s Zero-powered Matchbot 
crossed our Twitter feed. 
“Matchbot, which was built in just a couple of days, 
is just for a bit of fun really,” Mark tells us. “When the 
Pi Zero came out, I gave myself a challenge of building 


Matchbot was built in 
just a couple of days 


something really tiny. I really wanted a break from other 
things that I’ve been working on recently, and a chance 
to join in the fun of Pi Wars. Plus, as a nice simple robot, 
I hope to use it to help get our two girls interested in the 
Raspberry Pi and physical computing.” 

While it would have been amazing in itself to use 
spare robot kit he had lying around, Mark actually 


repurposed the parts of a CamJam EdukKit 3 to build it. 
“It’s built from a large matchbox, two tiny geared 
motors, plus wheels, and the rest (motor drivers, 
sensors, and battery box) is mostly from a CamJam 
EduKit 3. There’s also a 5V regulator so that it can use 
the motor battery to power the Pi.” 

As well as the motorised wheels, the Matchbot 
features ultrasonic distance sensors and a line- 
following sensor. 

Fitting the robot inside a matchbox is a feat in itself. 
However, the control interface for the Matchbot is 
inspired — with no WiFi to talk to it remotely, Mark 
has programmed the distance sensors to change mode 
depending on how long you hold your hand out in front 
of it, with a flashing LED giving you an indication of 
what mode you’ve activated. On the day, at Pi Wars, 
it handled the line-following course very well! 
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GAMING SYSTEM 


Spanner Spencer wasted no time hooking up the Pi Zero’s RCA 
connection to a classic cathode ray tube television. The Pi Zero 
Retro Gaming system is the real deal... 


» It works like 
a dream with 
Xbox 360 
controllers 


» The whole 
project took 
only two hours 
to build 


» The Pi Zero can 
be overclocked 
to 1GHz 
for gaming 


» Ituses 
RetroPie, part 
of the standard 
NOOBS 
installation 


» The Pi Zero 
can even play 
some original 
PlayStation 
games 


Using RetroPie on a classic 
CRT television is a great way 
to play old console games 


Attaching a USB joypad (like 
this Xbox 360 controller) 
enables you to play games 
with minimal setup 


A USB hub is placed on the side 
of the television. New games 
can be then added to RetroPie 
without opening the TV 


t’s fair to say that the 
PiZeno ¢aliiced mone 
than a bit of splash. Our 
new favourite smallest computer 
topped Twitter and caused chaos 
at British newsagents when it was 
cover-mounted on The MagP1. Even 
President Obama got a copy. 
Those lucky enough to get a 
Zero quickly created some great 


projects and discovered its nuances. 


That the Pi Zero has RCA output 
was not lost on Spanner Spencer, 
community manager at Elementi4, 
who realised it could be inserted 
inside an old television. 
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switched to using the composite 
video in on the SCART socket and 
then soldering the wires onto 

the PCB underneath to avoid 
external wiring. 

“The video signal came from 
the Pi Zero’s composite output, 
which I soldered directly. It’s a 
tad permanent, and it would have 
been better to add some pins 


“T picked up some crummy 
old Grundig for 20 quid ata 
charity shop in Huddersfield,” 
says Spanner. “It’s nice to think 
that the first ever Pi Zero games 
machine did its bit for charity. 

“Initially, | soldered a couple 
of flying leads to the back of 
the composite phono socket,” 
he continues, “but there was 
something skewey going on, and 
I didn’t get a picture. 

Instead, | 
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The wires from the Pi Zero are attached directly to the SCART board inside the TV 


The Pi Zero 1s small enough 
to tuck inside the television 


and a plug to make the board easier systems, you don’t even need to 


to remove, but there you go.” overclock it, so make it easy on 

The Pi Zero is small enough to yourself if you’re planning on 
tuck inside the television, but that playing Atari 2600 games.” 
makes it hard to access. However, Safety announcement! Working 
RetroPie enables you to transfer inside old CRT televisions is 
games by via a USB drive, so dangerous (and not in a cool way). 
Spanner decided to use a USB hub It is important to wear safety goggles 
to provide an external connection. and to discharge the electricity 


“We cobbled together a powered completely. Residual charge in an 
USB hub froma pound-shop hub,” —_ old CRT television can easily kill you. 


he tells us, “lLand] soldered a Please don’t open an old TV set if 
socket onto the power lines on the you don’t know what you’ re doing; 
PCB and replaced the cable witha it’s wiser to connect the RCA from 
butchered micro-USB one. We also _ the Pi Zero toa SCART cable and 

ran a second micro-USB cable out plug this into the television, or use a 
of the hub to power the Pi Zero, newer HDMI monitor for your retro- 
so both the hub and the board run gaming system. 


from a single 5V power supply. 
“Other than having to change 
the composite output from the 
default NTSC to PAL in the Pi Zero’s 
config file, it all worked right out of 
the box. We’re able to play classic 
computer and console games like 
the Mega Drive, SNES, Amiga, ZX 
Spectrum, and loads of others.” 
Une IE ZSice WS OUL UO lee msi 
for retro gaming. “Given the extra 
RAM overhead and being able to 
crank the Pi Zero up to 1GHz, it’s A cheap USB hub was adapted to 
coped with RetroPie beautifully,” provide external access to the Pi Zero 
inside the television 
says Spanner. “For the older 
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All the brains for the 
quadcopter are here -— the Pi 
Zero and the custom PCBs 


The drone is powered by four 
motors that are completely 
controlled by the software, 
not just turned on or off 


Awireless dongle allows 
the whole setup to be 
controlled remotely from 
a computer or phone 


Andy claims it’s 
taken him three 
years so far 


An older 
version 
appeared in 
The MagPi #19 


It couldn't 
actually fly 

for the cover 
image, though 


Raspbian 
Jessie fixed 

a number of 
programming 
errors 


It's only his 
second Pi 
project 


ANDY BAKER 


A networking software engineer, Andy 
is also the co-founder of the Cotswold 
Raspberry Jam. 
pistuffing.co.uk 


a 
ba 


ZOE tHE ZERO 


The first in what will more than likely be a swarm of Pi Zero-powered 
drones, Zoe the Zero is the continuation of a long-held dream 


hen we were planning 
issue 40 of The MagPi with 
its cover—mounted Pi Zero, 
we had a big brainstorm about the 
kind of projects we could do for 
features, and maybe also as future 
covers. One thing that we noted 
was that the Pi Zero could be great 
for powering quadcopters and 
other drones. In just over a month 
since the issue hit shelves, Andy 
Baker managed to start the trend 
and create his own drone. 
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“I completed my first Pi project 
(a wheeled ‘Turtle’ robot) in 
December 2012,” Andy tells us. “I 
wanted to move on to something 
that was a real challenge, and 
quadcopters were just starting 
to appear commercially. I was 
completely ignorant of how they 
worked, so 1 wanted to fill that 
gap in my understanding and have 
some fun at the same time.” 

Andy has spent the last few 
years building, testing, and 


experimenting to create his very 
own quadcopter from scratch: “I 
haven’ t finished yet, primarily 
because | actually wanted to 

work it out all by myself, without 
borrowing anyone else’s code 

or guidance. There was a lot of 
experimentation and learning 
involved, including a lot of wasted 
time taking the wrong direction 
and backing up when | hita 
metaphorical brick wall - or, more 
precisely, when | couldn’t stop 
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The Pi Zero looks a bit dwarfed by Zoe, but powers it just fine 


the quad from hitting a physical 
brick wall.” 

The Raspberry Pi Zero helped 
Andy bring Zoe back and make 
it operational again after a few 
tweaks. The years-long creation 
wasn’t always so quick or 
simple, though. 

“Other than having a custom 
HAT PCB, the physical build is very 
simple due to the off-the-shelf 
combination of frame, motors, 
and props,” says Andy. “But the 
software interfacing to hardware 
was a major challenge and the 
testing Inexpensive tne tlildte 
instability of a quadcopter means 
any imperfections ultimately end 
with a crash and corresponding 
hardware damage. Despite it ‘only’ 
costing about £200 to build the 
Pi Zero quadcopter from scratch, 
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it’s cost me more than ten times 
that over the last few years to 
reach this stage.” 

Interestingly enough, Andy 
doesn’t plan to really use the drone 
as such, instead treating itasa 
challenge to just make it work. 

“Tf it ever reaches that stage, I'll 
almost certainly shelve the project 
as complete and start on something 
new — perhaps a fusion reactor, or 
infinite improbability drive. But 
at the moment, there’s plenty of 
interesting stuff I can add to the 
very basic quad I have now to keep 
me interested for a long time yet.” 

While it may have taken Andy 
years, there’s now a lot more 
info and kits available to take a 
few shortcuts with. Hopefully, in 
the future, we can show you how 
to create your own quadcopter. 


ZOE THE ZERO 


Projects 
OPERATING ZOE 


we README 


>STEP-01 
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» The board 
works with 
any number of 
Pi Zeros 


» From idea to 
completion, the 
cluster took six 
weeks to build 


» ACompute 
Module is used 
in the Actbulb 


» The team have 
been studying 
the VideoCore 
GPU for future 
projects 


» The board is 
20cCM x 20CM x 
5cm, even with 
Pis attached 


92 


A full-size USB port 
is wired up to each 
Pi Zero 


16 Pi Zeros working in 
parallel means 16 1GHz 
cores and 8GB of RAM 
are available 


The board is powered by one 
supply on the rear that can 
activate all 16 Pi Zeros 


CLUSTER BOARD 


Turn your Raspberry Pi Zeros into a number-crunching cluster 
of computers with this custom-made board 


hen the Raspberry Pi Zero 

was being made, Eben 

Upton mentioned to us 
how one box of Pi Zeros holds 
hundreds of them. Hundreds of 
cores and hundreds of gigabytes 
of RAM - acrate of power, if used 
correctly. We never managed to 
work out the FLOPS one box could 
theoretically process, even if that 
might not be feasible. However, 
a Japanese company also saw the 
power of the Pi Zero in numbers 
and has created the PiZero Cluster 
Board, which allows up to 16 Pi 
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Zeros to do parallel computing. 
We spoke to Koichi Nakamura, 
representative director of Idein, 
Inc, about the cluster board: 

“When I was playing with 
Raspbemny PiZero, realised tliat 
costs of cables and adapters are 
relatively expensive, and found 
a solution that used micro USB 
plugs for cradles. I used this idea 
(@erealeOull COmolter Cllisteie. 
I think it’s useful for many other 
projects, [but it was] originally 
designed and developed for our 
internal purposes.” 


Idein is currently developing the 
Actbulb, a Pi-powered sensor suite 
that fits into standard lightbulb 
sockets to use in any way you See fit. 
Sensors include a microphone and 
cameras; it’s also internet-enabled 
and has an audio speaker. 

“Since we are developing products 
using Raspberry Pi, we needa 
cluster of many Pis for software 
development and tests,” Koichi 
explains to us. “It’s also useful to set 
up many other devices... We plan to 
create a cluster to enable setup of 
hundreds of our devices a day.” 
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-- The Pi Zero is plugged in via its 
micro USB power and data ports. Each 
unit also requires an SD card with an 
operating system installed 


It’s had a huge reaction online, 
with many people excited by the 
idea of the board. However, Koichi 
believes it’s quite a simple project: 

“PiZero Cluster Board is just a 
collection of 16 identical circuits. 
Each circuit draws one Ethernet 
port and one USB port from [each] 
Raspberry Pi Zero’s micro USB 
port, using an SMSC LAN9512 chip. 
There are also 16 power supply 
circuits to generate 5V and 3.3V 
from a12V single power source for 


We plan to create a cluster to 


Milesccsssessese sas so cn 
O06 46006686660000808| 


eo Bm 
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The Pi-powered sensor that 
necessitated the creation of the Pi 
Zero cluster board. It attaches to 
standard Light fittings 


“4 
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A Actbulb 


enable setup of hundreds of 
our devices a day 


Raspberry Pi Zero and LAN9512. All 
16 circuits are the same.” 

With Pi Zeros in short supply, 
the team were unable to secure 
SIMOUAIN WO CCD ene ie elSweT 
at first. Fortunately, we at The 


The insides of Actbulb are a lot more 
complex than a normal light bulb 
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MagPi managed to call in every 
favour, pull every string, and beg, 
plead and borrow to get them the 
Lemaimine 15:1 Zeros they meeded 
for tests. 

Due to the popularity of the 
board and its many uses, Koichi 
plans to put it on Kickstarter once 
they’re ready to crowdfund it. It 
will be an improved version of the 
prototype we’ve seen online. 

“In our current plan, the number 
of Raspberry Pi Zeros and USB 
ports is reduced to 14,” Koichi tells 
us. “We’ll also add an on-board 
Ethernet switch to the board, and 
the number of ports is reduced 
to two.” This improvement will 
reduce the number of Ethernet 
ports and cables required, and so 
lower the board’s overall cost. 
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Follow along to these hand-picked projects and learn how to make something truly amazing 


~ 


eC 


>. 


Ly 
P= 
{1s 
S 
\ 


To 


lie beereuey 


i. 
. 
Pes. 


eS 


ro 
"eit 
ot 
oe 
fd 
re 
of 
re 
cf 
ot 
oe 
7? 
tape 


ji, i. or oo : 


" ies] 
y | 
‘ F 


es The Official Raspberry Pi Projects Book raspberrypi.org/magpi 


al 


vit 


aS 
~a 


i; 
et 


raspberrypi.org/magpl 


GET STARTED WITH 
SENSE HAT 

Use your Sense HAT 
to take readings and 
display messages 


PIXEL ART WITH 
SENSE HAT 
Display tiny pixel 
characters on your 
Sense HAT 


GPIO ZERO TRAFFIC 
HAT 

Learn some basic 

GPIO Zero code by 
programming traffic lights 


TWEET WITH 
WOLFRAM 

Wolfram is free on 
Raspberry Pi and you 
can do some cool 
things with it 


TIMELAPSE 
PHOTOGRAPHY 
Create stunning 
timelapse videos by 
setting up a special 
project 


PUSH NOTIFICATIONS 
AND MOTIONEYE OS 
Make a smart CCTV 
system using a Pi and 
MotionEye OS 


P| GLOWBE 

A wake-light that helps 
you wake up more 
naturally in the morning 


PROGRAM CODEBUG 
IN PYTHON 3 

Use Python 3 to make 
a game on a little 
CodeBug 


PLAY WITH PIANO 
HAT 

Become the next 
Chopin by turning your 
Pi into a Piazo 


P| PHRASE 

Make a game show 
on Raspberry Pi and 
remember to say what 
you see 


MAGIC 
PRESENTATIONS 
WITH SKYWRITER 
Use Skywriter's gesture 
control to give your talk 
some pizazz 


BUILD YOUR OWN HAT 
Cant find a HAT that 
does what you want? 
Make one! 


lOT PLANT WATERER 
Automate your plant 
watering in this handy 
guide 


PIPE TEMPERATURE 
MONITOR 

Keep your house safe In 
the winter by checking 
your pipes 


P| MI-LIGHT 

Control wireless- 
enabled light bulbs for 
true home automation 


BUILD A BINARY 
CLOCK 

Create a beautiful and 
very different time piece 


GET STARTED WITH PI 
ZERO 

Learn the ins and out of 
the tiniest Raspberry Pi 


Pl ZERO ACCESSORIES 
Gear up your Pi Zero 
with these excellent 
add-ons 


PI ZERO CONSOLLER 
Create an advanced 
portable retro games 
console with its own 
rechargeable power 


PI ZERO RESET 
SWITCH 

Add avery simple 
button that will reset 
your Pi Zero 


SLACKTIVITY MONITOR 
Want to see how many 
messages you've 
missed on Slack? Build 
this monitoring 


PI-SABER 

Feel the force of 
electronics in this 
weaponised pool noodle 


QUAKE III IN A MOUSE 
Plug in a mouse to your 
TV and play Quake III on 
it. Magic! 


PI ZERO NES 
CONTROLLER 

Create a quick and easy 
retro games console 
inside a controller 
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Follow along to these hand-picked projects and learn how to make something truly amazing 
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GET STARTED WITH 
SENSE HAT 

Use your Sense HAT 
to take readings and 
display messages 


PIXEL ART WITH 
SENSE HAT 
Display tiny pixel 
characters on your 
Sense HAT 


GPIO ZERO TRAFFIC 
HAT 

Learn some basic 

GPIO Zero code by 
programming traffic lights 


TWEET WITH 
WOLFRAM 

Wolfram is free on 
Raspberry Pi and you 
can do some cool 
things with it 


TIMELAPSE 
PHOTOGRAPHY 
Create stunning 
timelapse videos by 
setting up a special 
project 


PUSH NOTIFICATIONS 
AND MOTIONEYE OS 
Make a smart CCTV 
system using a Pi and 
MotionEye OS 


P| GLOWBE 

A wake-light that helps 
you wake up more 
naturally in the morning 


PROGRAM CODEBUG 
IN PYTHON 3 

Use Python 3 to make 
a game on a little 
CodeBug 


PLAY WITH PIANO 
HAT 

Become the next 
Chopin by turning your 
Pi into a Piazo 


P| PHRASE 

Make a game show 
on Raspberry Pi and 
remember to say what 
you see 


MAGIC 
PRESENTATIONS 
WITH SKYWRITER 
Use Skywriter's gesture 
control to give your talk 
some pizazz 


BUILD YOUR OWN HAT 
Cant find a HAT that 
does what you want? 
Make one! 


lOT PLANT WATERER 
Automate your plant 
watering in this handy 
guide 


PIPE TEMPERATURE 
MONITOR 

Keep your house safe In 
the winter by checking 
your pipes 


P| MI-LIGHT 

Control wireless- 
enabled light bulbs for 
true home automation 


BUILD A BINARY 
CLOCK 

Create a beautiful and 
very different time piece 


GET STARTED WITH PI 
ZERO 

Learn the ins and out of 
the tiniest Raspberry Pi 


Pl ZERO ACCESSORIES 
Gear up your Pi Zero 
with these excellent 
add-ons 


PI ZERO CONSOLLER 
Create an advanced 
portable retro games 
console with its own 
rechargeable power 


PI ZERO RESET 
SWITCH 

Add avery simple 
button that will reset 
your Pi Zero 


SLACKTIVITY MONITOR 
Want to see how many 
messages you've 
missed on Slack? Build 
this monitoring 


PI-SABER 

Feel the force of 
electronics in this 
weaponised pool noodle 


QUAKE III IN A MOUSE 
Plug in a mouse to your 
TV and play Quake III on 
it. Magic! 


PI ZERO NES 
CONTROLLER 

Create a quick and easy 
retro games console 
inside a controller 
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Tutorial STEP BY STEP 


ROB ZWETSLOOT 


An avid coder and Raspberry Pi 
enthusiast with a history of building 
many things with a Raspberry Pi 
magpi.cc 


GET STARTED WIT 


> Sense HAT 
magpi.cc/ 
1TGGUt5 


> Sense HAT 
library 


> Raspbian - 
magpi.cc/ 
1MYYTMo 


The exciting new sensor add-on for the Raspberry Pi is very 
easy to use once you know how. We’1] show you how, then. 


his issue we’ve had a bit of a Sense HAT blow 

out, with our interview with the creators early 

on in the mag, and a review of it later on. It’s 
an amazing piece of kit and hopefully by now you’ve 
been able to snag yourself one. 

While it’s definitely easy to use, there’s a few things 
you need to learn first to get it going as it’s reliant on 
programming it via Python scripts at the moment. 
The commands are very simple though, so we can 
show you in only a couple of pages how to start getting 
the most out of your new toy! 


Learn how to use the 
features of the Sense 
HAT, and figure out 
how to make this 
smiley face 


All you need is a Raspberry 
Pi to use the Sense HAT - 
no other gadgets! 


S Sau 


7 he 
a‘ 
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Installing the Sense HAT 

Getting the Sense HAT ready to use is quite simple. 
Turn off your Raspberry Pi and make sure your 
Raspbian SD card is inserted if it isn’t already. Place 
the Sense HAT on the GPIO pins, carefully aligning 
them before pressing down firmly so that it properly 
attaches to the Raspberry Pi. Once that’s done, turn 
the Raspberry Pi back on. If it’s attached properly, 
the LEDs on the SenseHAT will light up in a rainbow 
pattern during boot time. When it gets to the desktop, 
the pattern might turn off but that’s normal. 


Sense HAT library 

The Sense HAT won't work straight away on every Pi. 
You may need to download a custom script that will 
install the necessary libraries for Python to access it 
if you're using a much older version of Raspbian, and 
update some of the core kernel code so that it runs 
properly. You can download and install the update by 
opening the terminal and running these commands: 


$ sudo apt-get install sense-hat 
$ sudo pip-3.2 install pillow 


After both commands have run their course (they 
might take a few minutes each to complete) you’ Il 
need to reboot the Raspberry Pi. You might as well 
do this from the command line with: 


$ sudo reboot 


Get started with Python 

We can start controlling the Sense HAT by writing 
code in Python. As the Sense HAT is using the GPIO 
pins, we need to have administrative privileges to 
execute the scripts. This means opening IDLE using 
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GET STARTED WITH SENSE HAT | Tutorial 


Oe oi, j 
taj Python Shel 


‘Bille Edt Shell Debug Options windows Help 


Python 3.2.3 (default, Har | 2013, 11:53:50) 
(occ 4.6.3] om Linnux2 


EASIER 
PAINTING 


pence «= SerumeHat () 

Set colours to 
specific letters 
using lists (e.g., 
red could be 
r=[255,0,0]). You 
can go even 
further and 
create a matrix 
of letters that 
can display an 
image 


bie Tities 
C = sense. get_temperature () 
p = Sere. get pressure () 
h = Senne. get_humidity() 


t = rowsxd(t, 1) 
p = rourml(p, I) 
h = round(h, 1) 


sense. show _message(meg, scroll speed=0.05) 
*/usr/lib/pythont/di st-packages/sense_hat /sente_hat. py", 
W¥ peasage 
tine .cleep (scroll speed) 
Keyboerdi ntersupt 


nog © “Tamperature « &9, Pressure=&s, Homidity«to* & (t,p,h) 


Bee alow _measage (magh 


Left You can set 
sensor outputs as 
variables to then 
be printed out on 
the LED, combining 
all the functions of 
the HAT 


sense.get_temperature() 
sense.get_pressure() 
sense.get_humidity() 


sudo in the command line with: 
$ sudo idle3 & 


You’ll have to attach them to a variable thought 
(e.g., t= sense.get_temperature()) so that you can 
print out the reading or display it on the LED matrix. 


>STEP-06 
Motion sensing 


The gyroscope, accelerometer and magnetometer 
can be used to detect motion in real time. This is 


Open up a new window to start writing a Python 
script. Each Sense HAT script needs to begin with two 
lines to import the relevant Python module, and then 
a line to turn it into a variable that makes writing the 
code easier. 


SLOW DOWN 
THE TEXT 


You can edit 
your scrolling 
text's speed 
by adding the 
scroll_speed 


from sense_hat import SenseHat option. Use 


something 


SenseHat ( ) 


>STEP-04 
Text and pictures 
The easiest thing to start off with is to get text 


sense = 


a little trickier to use than the other parts, as it 
involves understanding how the three-dimensional 
values represent the orientation of the Raspberry Pi, 
and then how the accelerometer can be used to figure 
out the movement within space. Both the gyroscope 


like: sense. 
show_message 
(“Hello 
World!”’, 
scroll _ 
speed=0.5) 


and accelerometer functions (get_orientation(). 
values() and get.accelerometer_raw().values() 
respectively) will return three values from which 
you can use however you please. 


scrolling along the LED display. The library for the 
Sense HAT will automatically turn a string of words 
into a scrolling banner across the matrix. A line like 
the following will create it: 


Below The most 
basic script you 
can write, but it's 
very useful to get 


This handy guide will explain all you need to know ie saga anger 
sense.show_message(“Hello World!”) on the motion sensors: http://bit.ly/1UBdEmA the Sense HAT 


You can control the scroll speed and colours as well. 
You can also manipulate the individual LEDs by telling 
the script which pixel to change, and give it an RGB 
colour variable with something like: 


dite" or “licemme()" fo 
PeSTAPT 


sense.set_pixel(@, @, [@, 0, 255]) 


Put this in a variable set the top left corner pixel as blue 


>STEP-05 

Environmental sensors 

Using two of Sense HAT’s sensors, you can measure 
temperature (in degrees C), pressure (in millbars) and 
relative humidity (as a percentage). You can get the 
three individual measurements with: 


raspberrypi.org/magpi 
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Need 


> Raspbian 
magpil. 
cc/1MYYTMo 


> Sense HAT 
magpi. 
cc/1TGGUt5 


> Pixel art 


INSPIRATIONAL 
CODE 


the Sense HAT may be 
simple, but it has a wide 
range of colours and is 
fully programmable 


PIXEL ARL 
ON 


~ ROB ZWETSLOOT 


; Tech writer, avid coder, and Raspberry 
Pi enthusiast with a history of building 
many things with Raspberry Pi 
magpi.cc 


Create simple images 
or more advanced 
pixel art to represent 
your favourite thing 


The 8x8 display on 


Make use of Python and the Sense HAT’s LEDs 


to read and display 8x8 pixel art 


e know what you’ re thinking: 8x8 pixel art 

doesn’t seem like a whole lot of pixels. And if 

you were thinking that, you’d be right. That’s 
64 pixels to try to convey something — simple for low- 
complexity objects, but for proper pixel art it seems 
like a tall order. If you think back to the early days 
of gaming, though, there are plenty of examples of 
sprites that didn’t use many pixels at all and looked... 
passable. The main limitations in those days were the 
number of colours you could have on screen at once, 
and with the Sense HAT we have the power to use a full 
RGB spectrum, utilising every pixel to make something 
a bit better than on the old Atari 2600. Grab a sprite, 
and let’s go! 


Get the Sense HAT ready 

If you’ve upgraded to the newer version of Raspbian, 
Jessie, all you need to do is switch off the Raspberry Pi, 
remove the power cable, and then plug the Sense HAT 
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on top of the Pi. Turn it back on and it’s ready to use. 
If you haven’t made the update, you’!l need to installa 
few extra libraries first. Open the terminal and run the 
following commands: 


sudo apt-get install sense-hat 
sudo pip-3.2 install pillow 


...and then reboot the Raspberry Pi (which you can 
also do in the terminal with sudo reboot if you wish!) 


Find some art 

There’s a few ways you can do this: using Google or 
searching on something like DeviantArt with the 
right keywords (‘88 pixel art’ is a good start) and you 
should be able to find a suitable sprite for showing off 
on your Sense HAT. You could also experiment with 

a square picture (from something like Instagram) to 
see what the code will spit out, or you can draw your 


raspberrypi.org/magpi 


own pixel art in something like Swanky Paint. For 
testing this tutorial, we grabbed one of the 100 
characters from a sprite sheet created by Johan 
Vinet (twitter.com/johanvinet), which can be 
found here: bit.ly/1jxaJ3m. 


>STEP-03 

Prepare the art 

The Sense HAT can only display 64 pixels, and our 
code assumes the image you have is going to be 
exactly that. On a normal computer, use an image 
editor such as the free software GIMP to prepare 
the image. Remove any borders (you may need to 
zoom right in to make sure) by cropping the image 
and save it to a file name you’1l remember with the 
extension .png or .gif. This is especially important 
if the 8x8 art you have isn’t actually saved as an 8x8 
image; for instance, if each ‘pixel’ in the art is six 
pixels wide, like in our code. 


>STEP-04 

Study the pixel art 

As mentioned above, your pixel art may not be 
actually saved by the pixel. In the code we’ve 
created, it takes this into account. The easiest way 
to check the width of the pixels is to look at the 
resolution of the image. In our case, it’s 48x48, 
which means that each ‘pixel’ is six real pixels wide 
(and high, because it’s a square). You can check 
this in GIMP by using a square pixel brush and 
increasing the size until it’s the same as the pixels 
in your image. Alternatively, once you’ve cropped 
the image, you can scale the image to be 8x8; this 
may not have the desired results, though, as it tries 
to squash everything together. 


>STEP-05 

Load it all on the Raspberry Pi 

Put the image on the Raspberry Pi and open it in the 
image viewer to make sure it transferred fine. We 
did this by plugging the SD card directly into the 
computer we prepared the image on and copied it 

to a directory called ‘SenseHAT’ in the home folder, 
but you can always put it on a USB stick and copy 

it over from within the Pi or upload it to your cloud 
storage and download it to the Pi. 


>STEP-06 

Write the code! 

Follow along to the code listing and tweak it to suit 
your own pixel art, whether this means you need to 
change the location of the file in the code (our code 
assumes you’ve put it in a folder called ‘SenseHAT’ 
in Raspbian’s home directory) or if you need to 
change the width of each pixel to 1 or higher. Press 
F5 to run the code, and it will then display the 
image on the Sense HAT for three seconds before 
turning itself off. 
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PIXEL ART ON SENSE HAT 


Pixelart.py 


from sense hat import SenseHat 


>PYTHON 


import time 
from PIL import Image 
import os 


# Open image file 
image file = os.path.join( 


os.sep,"/home", "pi", "SenseHAT", "pixelart.png") 


img = Image.open(image file) 


# Generate rgb values for image pixels 
rgb_img = img.convert('RGB' ) 
image pixels = list(rgb_img.getdata()) 


# Get the 64 pixels you need 
pixel width = 6 
image width = pixel width*8 
sense pixels = [] 
start_pixel = 0 
while start_pixel < (image width*64): 
sense pixels.extend(image pixels[start_pixel: ( 
start_pixel+image width) :pixel width] ) 
start_pixel += (image width*pixel width) 


# Display the image 

sense = SenseHat() 
sense.set_rotation(r=180) 
sense.set_pixels(sense pixels) 
time.sleep (3) 


sense.clear() 


*(lintithed | LO (RGR colour, 1 layer) Te Tee - DM 


a J 
eRe SZ 
BR B+ 5 


Above Rob is very vain, and (carefully) cut out 
an image of his alter-ego M. Bison to display on 
the Sense HAT, taken from Johan's sprite list 
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Traffic HAT 
magpi.cc/ 
1Mmaz7oD 


GPIO Zero 
magpi.cc/ 
aMmajnP 


Soldering iron 
(optional) 


USE 


Nice big lights are easy 
to solder on and use 
within the code as well 


The board slots neatly over 
the Raspberry Pi —- it will 
completely cover an A?! 


THE TRAFFIC HAT 


WITH GPO ZERO 


As one of the boards that GPIO Zero supports, the Traffic HAT 
is a perfect way to show off the library... 


he Traffic HAT is a great little kit: a GPIO- 
mounted add-on for the Raspberry Pi that 
makes learning how to program for physical 
computing a little easier and bit more fun, along with 
nice big components that can also help you learn the 
basics of soldering. 

With the release of GPIO Zero, the Traffic HAT is 
now easier than ever to program, whether you want to 
use it manually or make use of the handy Traffic HAT 
function built into GPIO Zero. Follow along with us as 
we teach you how to make the most of both the HAT 
and GPIO Zero. 


>STEP-01 

Prepare the Traffic HAT 

You can buy the Traffic HAT pre-soldered so that you 
don’t have to worry about it, but it’s a great beginner 
kit for learning how to solder. You only need to install 


Above We wrote the code on a computer and moved it to the 
Raspberry Pi, but there's no difference from writing it on the Pi itself 
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the main features you’1] be using: the three LEDs, the 
push-button switch, and the buzzer. 

Make sure to follow the outline guides on the board 
as to how to place them. The buzzer’s positive side is 
indicated on the component, and the board also has a 
euide showing which side it should be attached to. The 
LEDs should be soldered so the flat edge of the bulb 
meets the flat edge of the outline. 


>STEP-02 

Install the Traffic HAT 

Make sure your Raspberry Pi is turned off. Slot the 
HAT over the GPIO pins, with the board itself lying 
across the Raspberry Pi. This way, it shouldn’t be 
poking over the edge like a plank and will look likea 
normal addition to the Pi. 

Once that’s done, you can turn on your Raspberry 
Pi. Once booted up into Raspbian, you’ll need to make 
sure GPIO Zero is installed. This can be done by using 
the following commands in the terminal: 


sudo apt-get install python-pip python- 
withermsensor python-spidev 


sudo pip install gpiozero 


>STEP-03 

Basic GPIO Zero 

The LEDs have a GPIO number attached, as do the 
button and buzzer. We can use that in conjunction 
with GPIO Zero to activate the LEDs manually in the 
GPIO Zero style. Open up a new Python script in IDLE 
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USE THE TRAFFIC HAT WITH GPIO ZERO 
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Above You can also install the GPIO Zero software under Python 3; 
in fact, it's recommended by the creator. However, you'll need to 
change the print lines in our code 


and start it with the following code, so it knows what 
functions to use: 


from gpiozero import LED 


Then write in the following so the red LED, 
connected to GPIO 24, lights up: 


led = LED(24) 
led.on 


Press F5 to run It and see the results. Buzzer and 
Button are the other functions that you can import 
for the Traffic HAT. 


>STEP-04 

Dedicated GPIO Zero 

A slightly easier way of programming the Traffic HAT 
with GPIO Zero is by using the actual Traffic HAT 
function built into Zero. You can make use of it by 
changing the first import line to: 


from gpiozero import TrafficHat 


This makes use of buzzer, button, and lights 
functions to manage those respective parts of the 
HAT. The lights are then described as green, amber, 
and red in the code, for when you want to activate 
them. We’ll now create a little script to perform a 
traffic light sequence in Python. 


>STEP-05 

Setting up 

Looking at the code on this page, we have a simple 
setup by importing TrafficHAT and time. We’|l need 
the latter to simulate the kind of delay you normally 
eet on real traffic lights. Set the Traffic HAT code 

to be known as the variable th and we’re ready to 
begin our loop. 

Create a simple while loop that will continuously 
run. Start it by having the green light show, and use 
another while loop to stop the code until the button is 
pressed. It will stay green forever unless you press the 
button or interrupt the program. 
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Trafficlights py 


from gpiozero import TrafficHat 
from time import sleep 


th = TrafficHat() 


try: 
while True: 
# Traffic light code 
# First, turn the green LED on 
th. lights.green.on() 


>PYTHON 


print "Press the button to stop the lights!" 


# Next, we want to wait until the button is pressed 


while(th.button.is pressed == False): 
#While not pressed do nothing 
pass 


# Button has been pressed! 

th. lights.green.off() 

# Amber on for a couple of seconds 
th. lights.amber.on() 

sleep(2) 

th. lights.amber.off() 

# Turn the red on 

th. lights.red.on() 


# Buzz the buzzer 20 times with 9.1 second intervals 


th. buzzer. blink(@.1,0.1,20,False) 
sleep(1) 
th. lights.red.off() 


# Red off and blink amber 4 times with 9.5 second intervals 


th. lights.amber.blink(0.5,0.5,4, False) 


except KeyboardInterrupt: 
exit() 


A GPIO add-on that makes 
learning how to program for 


physical computing a little 


>STEP-06 
Light timing 
The bit of code after the button is pressed may 
seem a little complicated at first glance, but under 
closer inspection it should be fairly straightforward. 
It emulates the way traffic lights work at a pelican 
crossing, activating the amber light for a few seconds 
before giving a steady red light. 

When the red light appears, the buzzer will 
beep for a few seconds before the red light is 
turned off and the amber appears, this time 
flashing itself, before reverting back to green. 
At this point, the while loop starts again, waiting 
for a button prompt. 


easler 
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Tutorial 


A single function 
in the Wolfram 
Language can 
send a tweet 
from your Pi 


Authorisation is 
only required once 
for the Wolfram 
Language to tweet 
on your behalf 


> A Twitter account 


> The Wolfram 
Language 
Documentation 
Center 
magpi.cc/ 
1zOtbmno 


> Internet access 


PYTHON VS 


WOLFRAM 


DANA FLINN & BRETT HAINES 


Dana Flinn (Left) is a project administrator 
in Public Relations at Wolfram Research, 
and Brett Haines (right) is a junior 
software engineer in the Research 

& Development department. 
magpi.cc/10tbs5Af 
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WITH THE WOLFRAM LANGUAGE 


Dana Flinn and Brett Haines walk you through how to easily send tweets 
in the Wolfram Language, using the SendMessage function 


he Wolfram Language is a powerful knowledge- 

based language that makes computation 

accessible to everyone, and is an easy language 
to dip your toes into as a first-time programmer. To send 
tweets from Twitter on your Raspberry Pi, all you need is 
a single function. We’1] be using SendMessage, which is 
a multipurpose function in the Wolfram Language that 
gives Raspberry Pi users the ability to seamlessly tweet 
from their device. 

Using the SendMessage function, we'll walk you 
through how to apply the symbolic language and tweet 
using your Raspberry Pi. Don’t feel limited to just 
tweeting with this function, though! SendMessage can 
also be used to generate an email, update a Facebook 
or LinkedIn status, and generate a beep. 
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Prepare the syntax 

First, you need to launch your copy of Mathematica 
on your Raspberry Pi and open a blank notebook. 
With over 5,000 functions built into the Wolfram 
Language, it can seem intimidating at first. 
However, using the Documentation Center 

will make it simple to find the right function 

for your project. 

In the Wolfram Language, all functions use 
Square brackets and have names that start with 
capital letters. The function needed for this project 
is SendMessage, which is rather straightforward. 
It’s used to send a message to a specified channel, 
which in our case is Twitter. 
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TWEET WITH THE WOLFRAM LANGUAGE 
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>STEP-02 

Setting up your code 

To set up your code, open Mathematica on your Pi and 
type the SendMessage function, then the text you 
want your tweet to say. So, from the Documentation 
Center, we know it should be set up like this: 


SendMessage["Twitter", "Tweet text" ] 


Where it says “Tweet text”, the text can be changed 
to anything you want posted to your Twitter account. 


>STEP-03 


Evaluate your code 

Once you’ve typed that in, press SHIFT+ENTER. 

This will run your code in Mathematica and prompt an 
authorisation dialogue to allow the Wolfram Language 
to send tweets on your behalf. Once authorised, a 
tweet is sent to your account. Select ‘Done’ after 
entering the access key, and the tweet will appear in 
your Twitter stream. 


>STEP-04 

Create a variable 

The previous example showed a Static string being 
tweeted. However, this is far from all the Wolfram 
Language is capable of. Much like other programming 
languages, it allows users to set variables, in which 
we can store whatever we like. To create a variable, 
just type the name you want to give it, an equals sign, 
then whatever you want to assign to the variable, 

like so: 


myVariable = "Some string here!" 
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Tutorial 
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2). Hello world! 


Find more 
projects from 
the Wolfram 
team over on 
the Wolfram 
site: magpi.cc/ 
aSCpu2o 


Left You can 
tweet whatever 
message you want 
and it will appear 
instantly — limited 
to 140 characters, 
of course! 


Unlike several other programming languages, you 
don’t need to specify what kind of data is being stored in 
your variables — the Wolfram Language is smart enough 
to figure out what it is and how to use it on its own! 


>STEP-05 

Using StringJoin 

You can combine strings using the StringJoin 
function. Just like SendMessage, StringJoin is used by 
putting the strings you want to join in between square 
brackets ({ and ]), separated by commas. So, to join 
“Hello ” and “world”, you’d enter: 


StringJoin[ "Hello ", "world" ] 


This isn’t limited to static strings — variables can be 
joined to strings too, like so: 


StringJoin[ "Hello 


>STEP-06 

Combining it all 

Now it’s time to put it all together. We can take a 
variable, store a String to it, join it to another string, 
then send it to Twitter: 


» myVariable] 


myName = "WolframLanguage" 
SendMessage["Twitter", StringJoin[ "This 
tweet brought to you by ", myName] | 


Now that you know how functions work in 
the Wolfram Language, it’s easy to dive into the 
documentation and explore the thousands of 
functions built in. Now go forth and code! 
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> Raspberry Pi 


Camera Module 


magpi.cc/ 
1UaFuuW 


JAMES SINGLETON 


James is a software developer and 

, engineer. He founded Computing 4 Kids 
Education (C4KE) and Yo Flow online 
gym inductions. 
computing4kids.com 
unop.uk 


TIME-LAPSE 
PHOTOGRAPHY = 


Make a device to capture photographs at regular intervals. 


Then turn these images into a video 


ime-lapse photography reveals exciting things 
about the world which you wouldn’t otherwise 
be able see. Things that happen too slowly 
for us to perceive: bread rising and plants growing; 
the clouds, sun, moon, and stars crossing the sky; 
shadows moving across the land. In this tutorial, we’ll 
be making a Raspbian-based device that lets you watch 
things that are too slow to observe with the naked eye. 
To do this, we will capture lots of still photographs and 
combine these frames into a video with FFmpeg/libav, 
which can then be accessed via a web browser. 
The metal contacts on the 


ribbon cable should face away 
from the Ethernet socket 


The top of the camera is at 
the other end of the ribbon 
cable connection 
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Connect the Camera Module 

First, connect the camera module to the Raspberry 
Pi with the included ribbon cable. Locate the 
correct socket; it’s on the top of the Raspberry Pi 
circuit board and is the one furthest away from the 
micro-USB power connector. The socket is handily 
labelled ‘CAMERA’ on the newer Raspberry Pi 
models. Lift up the outside of the socket to release 
the clamp, then insert the ribbon cable with the 
metal contacts facing towards the micro-USB power 
connector. Finally, hold the ribbon cable in position 
and push the outside of the socket back down to 
clamp the cable in place. 


Enable and test the camera 

Power the Raspberry Pi up. You now have a choice: 
boot to the command line, open a terminal window, 
or establish a secure shell (SSH) connection. Enable 
the camera by running this command from a terminal 
to launch the Raspberry Pi configuration tool: 


sudo raspi-config 


Then select the 'Enable Camera’ option. You can 
test the camera by running the following command: 


raspberrypi.org/magpi 


— 


raspistill -o testimage. jpg 


The red LED on the camera module should light up 
for 5 seconds and a JPEG image will be saved to the 
current directory. If the camera is mounted upside 
down, then you can use the vertical and horizontal 
flip command-line switches (-vf and -hf). 


>STEP-03 
Install and configure software 


Install a web server to access your images remotely. 
Run this command to install Apache: 


sudo apt-get install apache2 


Remove the default page to see the contents 
of the directory: 


sudo rm /var/www/index.html 


Visit the IP address of your Pi (e.g. http://192.168.1.45 
— you can find this by using ifconfig) and you should 
see an empty directory listing. If you run the following 
command and refresh the page, you should see an 
image file listed. You run this as a superuser so you can 
write to the directory. 


sudo raspistill -o /var/www/testimage. jpg 


Click on the file link and you’ |] see the image 
in your browser. 


>STEP-04 
Capture the images 


Set up your scene and check the positioning 
of the camera. 


sudo raspistill -w 1920 -h 1080 -o /var/ 
www/testimageFullHD. jpg 


The width and height have been changed to capture 
a smaller image in 16:9 aspect ratio. This makes 
things easier later. The top and bottom are cropped, 


Below Some bread dough ready to prove. Watch it rise in your 
video. Be careful not to move the bowl or camera during filming 


TIME-LAPSE PHOTOGRAPHY 


Tutorial 


raspberrypi.org/magpi 


so make sure that your subject is in frame. Run this 
to start the capture: 


sudo raspistill -w 1920 -h 1080 -t 10800000 
-tl 10000 -o /var/www/frame%04d.jpg & 


This takes a photograph every ten seconds 
(10,000 milliseconds) for three hours (10,800,000 
milliseconds). The ampersand (&) at the end runs the 
process in the background. 


>STEP-05 

Prepare to make the video 

You can render the video on the Raspberry Pi, but it’ll be 
very slow. A better way is to transfer the files to a more 
powerful computer. In any case, you’ ll need to install 
the tools on the rendering machine; for the Pi, enter: 


sudo apt-get install libav-tools 


This installs a fork of FFmpeg, but you can also use 
the original FFmpeg. To copy the images to a remote 
machine, you can download them from the web server 
using weet or curl. For example: 


wget -r -A jpg http://192.168.1.45 
Or if you don’t have weet... 


curl http://192.168.1.45/frame 
[@001-0766].jpg -O 


Change the IP address and numbers accordingly. 


>STEP-06 

Make the video 

The final step is to make the video. Run this command 
to start the rendering process: 


sudo avconv -i /var/www/frame%e4d. jpg 
-crf 4 -b:v 10M /var/www/video.webm & 


When this has finished, you’1] be able to view the 
video in your browser. The default frame rate is 25fps. 
This compresses three hours of frames at ten-second 
intervals to about forty seconds of video. You can adjust 
this with the -framerate command-line option. The 
bitrate (-b) has been set high, and the Constant Rate 
Factor (-crf) low, to produce a good-quality video. 


Above Shell 
running the 
rendering process 
on the Raspberry 
Pi. This will take 
some time, so you 
may prefer to use 
a faster machine 


MAKE AN 
ANIMATED GIF 


Instead of 

video, make 

an animated 

GIF with 
ImageMagick. 
Use smaller 
images, captured 
less frequently. 


sudo convert 
/var/ www / 
frame".jpg /var/ 
www/anim.gif & 


OTHER VIDEO 
FORMATS 


WebM is an open 
video format that 


can be displayed 
directly in 

most browsers. 
However, other 
video formats 
are available. 
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Cat Cam 


Send An Email oF 
Call A Web Hook of 


Run A Command Om 


Command /data/pushover py 


DD PUSH 


= WESLEY ARCHER 
- (AKA RASPBERRY COULIS) 


4 Self-taught Raspberry Pi enthusiast, 
- now writing guides for Pi Supply's 
Maker Zone to help others get 
involved in gadgety goodness! 
magpi.cc /2dtoUBL 
@RaspberryCoulis 


Busted! This is what your 
camera sees (and records) 
when motion is detected 


This is where you'll tell 
MotionEyeOS to run 
your Python script 


me NOTIFICATIONS TO 


magpi.cc/ 
12UCwiJk 


> Raspberry Pi 
Camera Module 


> Pushover app for 
iOS or Android 
with full licence 


eee MotionEyeOS is perfect for using your Pi as a CCTV camera. Want to detect 


pushover.net 


ne benefit of MotionEyeOS is its ability to 
detect motion and capture images and movies 
of what triggered it. You can also access a live 
stream of your camera online, even when you’re not 
home, which is handy if you want to check in every 
now and then. When away from home, being notified 
of any movement is very useful, and MotionEyeOS has 
a nifty option for custom notifications. 
This guide will assume you have already set up 
and configured MotionEyeOS. A Pushover licence is 
required, which costs £3.99/S4.99. For help, check out 
the MotionEyeOS wiki here: magpi.cc/1UCVYwV. 


Make sure 

you turn on ‘Run 

A Command’ and 
then include the 


path to your script! Send An Email 


Call A Web Hook 


Run A Command ON 


Command /|/data/pushover.py 
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movements while you’re out? Then read on... 


Create an application in Pushover 

Pushover has a great, easy to use API. Before we start, 
we need to register an application with it. Click on 
Register Application under the Your Applications 
heading on the Pushover website (pushover.net). Give 
your app a name — something like RaspiMotion — and 
then make sure the type is Application. Give your app 
a quick description (e.g. ‘Push notifications sent by 
my Raspberry Pi’) and, if feeling creative, upload a 
custom icon which will show in your Pushover client 
app whenever a notification is sent. 


Get your API token and user key 

Once you have created your application, you should 
have access to an API token/key. This is a unique 
combination of numbers and letters — please keep 
this a secret! You’ll also need your user key, which 

is shown once you log into Pushover’s website. 

Okay, so you have an app and your API and user keys. 
You'll now need to download (or recreate if you so 


raspberrypi.org/magpi 


ADD PUSH NOTIFICATIONS TO MOTIONEYEOS 


pushover. py 


import httplib, urllib 


conn = httplib.HTTPSConnection("api.pushover.net:443") 


conn.request("POST", "/1/messages.json", 
urllib.urlencode({ 
"token": "APP TOKEN", 
"user": "USER TOKEN", 


"Heme 2. 

"title": "Motion Detected!", 

"message": "<b>Front Door</b> camera!", 
TPL 2 helps) / PP-ADDARE.SS 

"url title": "View live stream", 
"sound": "siren", 


>PYTHON 


DOWNLOAD: 
magpi.cc/ 
20DHpYW 


Insert app token here 

Insert user token here 

1 for HTML, 9 to disable 

Title of the message 

Content of the message 

Link to be included in message 
Text for the link 

# Define the sound played 


+ HH H HH OF OF 


}), { "Content-type": "application/x-www-form-urlencoded" }) 


conn.getresponse() 


wish) a simple Python script to tell your Raspberry 
Pi to work its magic once the script is called upon 
by MotionEyeOS. 


>STEP-03 

Create your Python script 

MotionEyeOS is not like Raspbian. You cannot use 
certain commands as you would normally, such as 
git clone, so we’ll have to create our Python script 
manually; you can also drag and drop using WinSCP 
if preferred. We also don't need to use sudo, as we’re 
already logged in as root by default. Our script needs 
to live in the data folder, so let’s go there and create 
pushover.py using nano: 


cd /data 
nano pushover.py 


Once here, you’1l need to copy and paste or type in 
the code listing, while also including your API token 
and user key where required. 


>STEP-04 

Make your script executable 

As with any script, we need to make sure it can be 
executed, otherwise it's nothing more than a fancy 
collection of text! You can do this either from the 
command line or from within WinSCP. From the 
command line, make sure you're in the data folder 
and then type: 


chmod +x pushover.py 
Or, if using WinSCP, select the pushover.py file in 
the data folder, then press Fg. In the window that 


appears, change the permissions to 0755 and then click 
‘OK’ to confirm. 
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Create New Application/Plugin 


m8 Tae? Oe ee 


Apo cation Intonneior 


hon [ Si Mm co Left Create an app 
oa sain . via Pushover.net to 
get the ball rolling. 
It's pretty self- 
explanatory 


>STEP-05 

Configure MotionEyeOS to use your script 

Now that we have our script, we need to tell 
MotionEyeOS to use it when it detects motion. To 

do this, log in, go to the Motion Notifications menu 
and turn on the ‘Run A Command?’ option. You then 
need to specify which command to run, which will be 
the Python script you just created — this is 
/data/pushover.py. Click Apply once done, to 
confirm the changes. 


>STEP-06 
Test it out! 
Hopefully, by now you have created your Python 
Script, made it executable, told MotionEyeOS to use 
your script when it detects motion, and have the 
Pushover app installed on your smartphone or tablet. 
We now need to test that it works! Wave your hand in 
front of your camera (or you can do a dance if you're 
feeling energetic!) and then shortly afterwards you 
should receive a notification via Pushover, warning 
you that motion has been detected! 

Feel free to experiment with the script to 
customise the message displayed and sound played 
in Pushover. 
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Tutorial 


Adiscarded globe froma 
charity shop is the perfect 
thing to create the wake-light 


> Sense HAT 
magpi.cc/ 
aTGGUt5 


> BlinkyTape 
LED strip 
(or NeoPixel / 
DotStar) 


> An unwanted 
globe 


> Plastic bottle 


> Sticky pads 


> Blu-Tack 
or putty 


The main light for the alarm 
is much brighter than the 
Sense HAT LEDs 


JAMES SINGLETON 


James is a developer, engineer, 
and author. He helps people find 

_ software jobs in the environmental 
sector with ‘Cleanweb Jobs’. 
unop.uk 

cleanwebjobs.com 


It's all powered by the 
Raspberry Pi, timed to go 
off when you need it to 


Py ae 


THE PI-POWERED 
WAKE-LIGHT 


Turn a globe into a glowing orb and use it to help you wake up 


in the dark winter months 


uring the winter, or even at any time of 

the year, it can be difficult to get up in the 

mornings. If you wake before dawn, your 
body still thinks it’s night (because it is). You can 
buy wake-lights that trick your body into waking 
up by simulating a fake sunrise; they get gradually 
brighter as your alarm approaches. These can be quite 
expensive, so why not make your own with a Pi and 
some LEDs? To celebrate the Astro Pis on the ISS, 
we’ve built one using a Sense HAT inside a globe that 
was found in a charity shop — perhaps an unwanted 
Christmas present, now repurposed! 
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Make an LED bulb 

Create a bulb by wrapping an LED strip arounda 
plastic bottle. You could skip this, but the Sense HAT 
is not bright enough to make a lamp. Cut the top off 
an empty plastic bottle, cover it in sticky pads and 
wrap the LED strip around it in a spiral. You can secure 
the ends further with tape. Have the connection end 
at the wider opening so that you can route the power 
cable to the Pi and then out through the centre. We’1l 
mount the Pi on top of the upside-down bottle end, 
so ensure it's flat. 


raspberrypi.org/magpi 


>STEP-02 

Destroy the world 

Remove the Earth from its mount by pulling the 
pegs of the holder out of the holes in the Arctic 
and Antarctic. Next, split it in half along the equator 
by pulling the two hemispheres apart. It should 
disassemble fairly easily with a little force applied 
in the correct places. You’1l want to fashion a new 
mount to stop the globe rolling around, whilst still 
allowing the power cable to exit from the bottom 
hole - you could use the inside of a roll of tape. 
You can cut a small slot with a knife to allow 

the wire to enter. 


>STEP-03 


Mount inside globe 

Attach your new LED bulb to the inside of the globe. 
Mount the neck of the bottle over the lower hole 

with Blu-Tack or putty; it should be sturdy enough 

to support the weight of the Pi resting on top of it. 
Mount the Sense HAT on the Pi, and then place both 
on top of the upturned bottle. Attach a USB WiFi 
dongle to the Pi (unless you’re using wired Ethernet), 
otherwise it will wake you at the wrong time. This is 
because the Pi requires internet access to set its clock. 


>STEP-04 

Route the power 

You’ll probably need to cut and reconnect the 

power cable to fit it through the hole. The official 

Pi power supply uses bell wire, which makes it easy 
to reconnect with a screw terminal (choc block). 
Unfortunately, it doesn’t supply enough power to use 
the LEDs at full brightness and also run the Pi. Cut 
the cable and insert the supply end through the hole. 
Tie a knot in the cable to stop it from being pulled 
back through. Separate the two power cores from 
both ends and strip the insulation. Reconnect with 

a choc block, matching the polarity. 


>STEP-05 
Download the code 


Clone the code from the GitHub repository into your 
home folder: 


git clone https://github.com/jpsingleton/ 
pi-glowbe.git 


If you’re only using part of the hardware or 
a different LED strip, you can adapt the code 
to your needs. You may also need to install the 
Sense HAT software if you’re running an older version 
of Raspbian — follow the instructions at 
magpi.cc/1KboHnN. You may also want to disable 
the LEDs on the Pi so they don’t disturb your sleep. 
Newer models can do this in software, otherwise you 
could tape over them, or even de-solder them if you’re 
brave enough. 
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Tutorial 
qanguage 


>PYTHON 2.7 


P| GLOWBE 


wakeup.py 


from BlinkyTape import BlinkyTape 
from sense hat import SenseHat 
from time import sleep 

import optparse 


DOWNLOAD: 
magpi.cc/1TUKdz7 


# Default Blinky Tape port on Raspberry Pi is /dev/ttyACM@ 


parser = optparse.OptionParser() 
parser.add_ option("-p", "--port", dest="portname", 


help="serial port (ex: /dev/ttyACM@)", 


default="/dev/ttyACMe" ) 
(options, args) = parser.parse args() 


if options.portname is not None: 
port = options.portname 

else: 
print "Usage: python wakeup.py -p <port name>" 
print "(ex.: python wakeup.py -p /dev/ttyACM@) 


exit() 
sense = SenseHat() 
bt = BlinkyTape(port) 


# wake phase - gradually get brighter, linearly 
SleepTime = 18 # 18 sec for 30 min in 10@ steps 
maxPower = 100 # flickers or cuts out above 100 


for y in xrange(maxPower): 
sense.clear(y * 2, y * 2, y * 2) 
for x in xrange(sleepTime): 
bt.displayColor(y, y, y) 
Ssleep(1) 


# on phase - at full brightness for the same time 

sense.clear(255, 255, 255) 

for z in xrange(maxPower * sleepTime): 
bt.displayColor(maxPower, maxPower, maxPower) 
sleep(1) 


# tidy up 
sense.clear() 


>STEP-06 

Set up your schedule 

We’ ll run the code with cron. It should start about half an 
hour before you get up and probably only on weekdays. 
Launch the cron configuration by typing the following 
into a terminal: 


crontab -e 
Next, set it up by adding the following line to the end: 


15 6 * * 1-5 python /home/pi/pi-glowbe/ 
wakeup. py 


This will run the code every weekday at 06:15, so change 
it to meet your needs. Save the file and exit the editor 
(CTRL+X, Y, then ENTER in the default nano). Once 
happy, reassemble everything and wait for morning! 
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Tutorial STEP BY STEP 


PROGRAM 


TONY GOODHEW 


Taught programming since 1967 
(IBM 1130 with FORTRAN IV). BBC 
Micro teacher trainer, now using 
Raspberry Pi and Arduino. 


WITH 


Move on from Blocky programming and control 
your CodeBug with all the power of Python... 


he CodeBug is simple to set up and start 
> CodeBug programming with the Scratch-like Blocky Game rules 


magpi.cc/ interface on the website. Once you have We need a simple game in which you press a button 
aMelyfA 


mastered this, you'll probably want tomoveontothe  whena target is in acertain position. Back in the late 

> USB Micro B next stage and take full control with a more powerful 1970S, your expert used to set a ‘Zap the Rat’ game as 

Spree capone! language like Python 3. This allows you to include homework while teaching Commodore PET or Ohio 
ae Sge =§=more ambitious data structures, such as lists and Scientific Basic. You have to click a button as a moving 

python3-serial i eer — 

omens tuples, and build larger projects with procedures. rat target passes a certain zapping point’ ona | 

codebug-tether Your expert started to wonder how good a game you circuit. In this version, the speed increases each time 
y codeBug script could build with just a square of 25 LEDs andaswitch. you successfully hit a rat, and you need to hit three 

codebug-tether. This is his first attempt. rats with as few attempts as possible. It would be nice 


cog to display the hits while the game is running, anda 
es aie final score to show how many times you missed the 
target. Can all of this be fitted on a5*x5 LED display? 


Raspberry Pi 2 Medel B V1.1 
() Raspberry Pi 2014 


_SOPER PRR REhOrtTT 


Stk be. ee = 


kt Pes Le 


eee eeee 
; 


Tethered witha 
Micro USB cable 


This is the zap position 


Se 
“Hee 
- 


This shows the rat at (4,0), the zap 
position marker, and hits counter at two zaps 
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PROGRAM CODEBUG WITH PYTHON 3 


Tutorial 


qanguage 


Above The final score: seven missed opportunities to zap the rats 


>STEP-02 


Planning the display 

The circuit will be all the outside edge LEDs, with the 
rats starting their run from the bottom -left corner: 
(0,0). The zap cell will be at (4,2), with a permanently 
lit LED at (3,2) to mark it. Hits can be indicated bya 
column of lit LEDs rising from (1,1) to (1,3). Button 

‘B’ will be used to zap the rat. The final score can be 
displayed with either a character ‘O’ to indicate no 
missed zap opportunities - quite difficult to achieve - 
or lit LEDs (0 -25) for each miss. For a ‘hit’ to register, 
the button must be pressed while the zap position LED 
is lit, holding the button down won't work. 


>STEP-03 

Setting up the CodeBug 

To run the CodeBug in tethered mode, you'll 

need to download and install a program called 
codebug_tether.cbg. Once installed in the normal 
way, the CodeBug temporarily becomes a slave device 
to your Raspberry Pi and obeys instructions sent from 
Python 3. (This is rather like using Nanpy to control 
an Arduino from a Pi.) 

Two additional Python libraries, python3-serial 
and python3-codebug-tether, need to be installed 
on the Pi. Point your browser to magpi.cc/iMeIWdR 
and follow the excellent instructions from Thomas 
Macpherson-Pope. 

Open IDLE 3 and type in the Zap_the_rat.py Python 
Script. Save it and run it. 


>STEP-04 

Things to do 

There are several modifications and additions you 
could make to the script: 


> Randomise the rat’s starting position 


>» Randomise the direction in which the rat runs 
around the circuit 


> Improve the zero final score to a Square, expanding 


and contracting from position (2,2) to the edge and 
back again five times as a celebration. 
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Lap_the_rat.py 


# Za 


>PYTHON 


p the Rat - Python3 Game for Tethered CodeBug 


# Tony Goodhew - 5 Oct 2015 
import codebug tether 
import time 


CD = 


(alalale 


# Circuit LED co-ordinates - round the edge from bottom-left 


codebug_ tether .CodeBug() 
lear() 


LEDx =(0,0,0,0,0,1,2,3,4,4,4,4,4,3,2,1) 
LEDy =(0,1,2,3,4,4,4,4,4,3,2,1,0,0,0,0) 


TOP 


score = 0 


opps 
p= 
dela 


old _ sw = @ 


runn 
elayare 
cb.s 


whil 


Gbec 
opps 
prin 
it Oo 


if oO 


else 


time 
ebr.c 


i in range(@,-66,-1): # Display game title 
cb.write_text(i,@,'Zap the Rat', direction="right") 
time.sleep(0.1) 


# Rats zapped! 
= 0 # Zap opportunities 
i) # Position of rat on circuit (@-15) 
y = 0.05 # Initial delay between rat moves 
# Last value of switch B 
ing = True # Loop control variable 
lear() 
et_pixel(3,2,1) # Show Zap position 
e running: 
cb.set_pixel(LEDx[p],LEDy[p],1) | # Show rat 
if p == 10: Opps = Gpps +1 # 
time.sleep(delay - score * @.007) # Wait - gets faster 
Sw = cb.get_input('B') # Read switch B 
pixel = cb.get_pixel(4, 2) H 
cb.set_pixel(LEDx[p],LEDy[p],@) | # Hide rat 
if old_sw == @ and sw == 1 and pixel == 1: # Hit? 
score = score +1 
cb.set_pixel(1,score,1) 
if score == 
running = False 
p= -1 
Old sw = sw 
oF Spl ae il 
it po 1S: 
p = @ 


# Increment hits 
# Show hits 

# Game over? 

# Stop looping 
# Position of next rat 

# Store switch value 

# Update rat position 

# Rat pointer out of range? 
# Reset to start position 


lear() 
= opps - 3. # Remove successful opportunities 

t( "Missed Opportunities were ",opps) 

pps > 25: # Reduce missed opps to 25 max 

opps = 25 

Pps == 

cb.write text(0,0,'O') # Zero missed opps 


# Game over - display opportunities 


for x in range(0,5): 
for y in range(@,5): 
if Opps > 0; 
cb.set_pixel(x,y,1) 
else: 
cb.set_pixel(x,y,9@) 
opps = opps - 1 
-Sleep(5) 
lear() # Tidy display 


# Display missed opps 
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Incr opps = in (4,2) 


Rat in Zap position? 
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Tutorial 


PLAYING IT 
BY EAR WITH 


PIANO HAIL 


The latest HAT from Pimoroni is a great way to unleash your ivory- 
tinkling tendencies. Let’s use it to build a relative pitch tester 
>STEP-0O1 


Getting started with Piano HAT 
Like most HATs, this one is straightforward to use. 


elative pitch is the ability to identify a given 
musical note by comparing it to a reference 
note. Unlike perfect pitch, relative pitch can 


A Piano HAT 
magpi.cc/ 
1OALWNT 


The Piano-HAT 
library 
magpi.cc/ 
2dXkyIM 


Headphones 
or an external 
speaker 


Each touch panel has 
a corresponding LED 


be improved with training. The Piano HAT is a versatile 
piece of hardware that we can use to create a fun game 
that tests people’s skill in recognising different notes. 
It was inspired by Zachary Igielman’s legendary PiPiano 
and it turns your Pi into a functional musical keyboard. 
Each of the 16 capacitive keys also has an LED so you 
can create you own ‘learn to play’ tutorials or just give 
your performances a visual appeal. 


Sixteen capacitive 
touch panels are 
used as the keys 
and control buttons 
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Simply plug it carefully onto the GPIO pins of your 

Pi. Then install the Piano-HAT Python library. This 
requires the ?C bus on the Pi to be enabled, and there 
are plenty of instructions for this online. But to make 
life super-easy, those Pirates at Pimoroni provide a 
handy script that takes care of everything: 


curl -sSL get.pimoroni.com/pianohat | bash 


>STEP-02 

Wired for sound 

There are two options for getting audio output from 

a Pi. If you are using a HDMI monitor or a TV that has 
built-in speakers, the audio can be played over the 
HDMI cable. If not, you can switch to use headphones 
or a speaker plugged into the headphone jack. The Pi 
will normally auto-detect the available outputs, but 
sometimes it gets this wrong. To force audio to use a 
specific output, you can use this command: 


amixer cset numid=3 2 


The second number determines the output: 
HDMI = 2, jack = 1, auto = 0. 


>STEP-03 

Play it again 

The Piano-HAT library has a nice collection of 
demonstration Python scripts. A good one to start with 
lets you use the Piano HAT as... a piano! 


sudo python Pimoroni/pianohat/ 
Simple-piano.py 
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PLAYING IT BY EAR WITH PIANOHAT | Tutorial 


ftelative_Pitch.py 


>PYTHON 2.7& 3 
import pianohat # import libraries we need for x in range(16): # DOWNLOAD: 
import pygame Flasheali~ the iitents to celebrate magpi.ce/2dXjJj9 
import time, random pianohat.set_led(x, 

True) 
pygame .mixer.pre_init(44100, -16, 1, 512) #Configure pygame sound time.sleep(@.05) 
pygame.mixer.init() #Initialise pygame mixer for x in range(16): # Them turn them off 
pygame.mixer.set_num_channels(16) pianohat.set_led(x, False) 
pianohat.auto_leds(True) # LEDs light when keys pressed pianohat.auto_leds(True) 
# A dictionary mapping sounds and notes onto keys correct = True 
NOTES = {'@':['C','./sounds/piano/39172__jobro__piano-ff-0@25. else: 
wav'], #C print('wrong, try again’ ) 
'1': ['C Sharp', './sounds/piano/39173 jobro__piano-ff-026. 
wav'], # C sharp def play(note): # Play a note from the dictionary 
'2':['D','./sounds/piano/39174__jobro__piano-ff-027.wav'], # D pygame.mixer.Sound(NOTES[note][1]).play(loops=@) 
'3':['D Sharp','./sounds/piano/39175__jobro__piano-ff-028.wav' ], time.sleep(1) 
# D sharp 
"A':['E','./sounds/piano/39176__jobro__piano-ff-029.wav'], # E pianohat.on_note(handle_ note) # Set keys to use our handler 
'S':['F','./sounds/piano/39177__jobro__piano-ff-030.wav'], # F 
"6':['F Sharp','./sounds/piano/39178__jobro__piano-ff-031.wav' ], while True: 
# F sharp print('Here comes a C') 
'7':['G','./sounds/piano/39179 _jobro__piano-ff-@32.wav']|, # G time.sleep(1) 
'8':['G Sharp','./sounds/piano/3918@__jobro__piano-ff-033.wav' ], play('@') # Play a C 
# G sharp time.sleep(2) 
'9':['A','./sounds/piano/39181__jobro__piano-ff-034.wav'], #A correct = False 
'10':['A Sharp','./sounds/piano/39182__jobro__piano-ff-035.wav' ], print('Now identify this note’) 
# A sharp time.sleep(2) 
'11':['B','./sounds/piano/39183 jobro__piano-ff-036.wav'], # B note = random.choice(list(NOTES)) # Pick a random note 
'12':['C', './sounds/piano/39184 jobro__piano-ff-037.wav'] # C play(note) 
} print('press the key for the note you heard’) 
count = 6 # Set countdown timer 
def handle _note(channel, pressed): # handler for key presses while count > @ and correct == False: 
global note time.sleep(1) 
global correct print(str(count) + ' Seconds remaining’ ) 
if channel < 13 and pressed: # Only for note keys count -=1 
if str(channel) == note: # Did the player get it right? if not correct: # If they didn't get it right, tell them the 
print('correct, it was a ' + str(NOTES[note][0]) ) answer 
pianohat.auto_leds(False) print("time's up, it was a " + str(NOTES[note][0])) 
If you press the Instrument key, you’1l notice that Add this line immediately before the handle_note 
the sounds change from pianos to percussion. The function in Listing_l1.py. Now we can add code so that 


Piano-HAT library itself does not map any of the keys only the D key’s LED will work. Insert 
to a particular sound; that is all done using Python. The 


sounds themselves are WAV files, which are played pianohat.set_led(2, True) 
using the Pygame library. 

Let’s map our own sound to one of the Piano HAT’s ...before the pygame.mixer. Sound line and 
keys. Find a short WAV file online (or create your own 
using Sonic Pi) and save it as mysound.wav. Then type pianohat.set_led(2,False) 
in the code from Listing_l1.py (on page 52) and run it: 
your sound should play when the D key is pressed. ...after it. 

Now rerun the program to verify that only the D 

>STEP-04 lights up when tapped. 
A little light music 


You’ll notice that the relevant LED lights up when any >STEP-05 
key is pressed. This is the default behaviour, but can be Use a dictionary 


disabled using: Mapping keys to sounds using a bunch of if... 
statements is easy but rather long-winded. For our 
pianohat.auto_leds(False) relative pitch test, we want to associate the key (an 


integer) with the note (a text string) and the sound 
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to be played (also a string). A simple way is to use a 
Python construct called a dictionary. A real-world 
dictionary has an index of words, and each word has 
definitions. In a Python dictionary, the word is called 
the ‘key’, and the definitions the ‘values’. 

Listing _12.py uses a simple two-item dictionary to 
map sounds and names (the values) onto the C and D 
keys (the keys). Give it a try. 


Putting it all together 

We’ ve now explored everything needed for our 

relative pitch tester: we’ll use the piano sounds 

that come with the Piano-HAT library for our notes. 
Type up the code from the Relative_Pitch.py 

listing (on page 51) and run it with sudo. A reference 


[sting 0 py 


pianohat 


pygame 
Signal 


pygame.mixer.pre_init(44100, -16, 1, 512) 
pygame .mixer.init() 
pygame.mixer.set_num_channels(16) 


def handle_note( ; Ne 
channel 
pygame.mixer .Sound( 
).play( Q) 


pianohat.on_note(handle_ note) 
Signal.pause() 
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In a Python dictionary, the 
word 1s called the key, and 
the definitions the ‘values 


note (aC) is played, then, after a pause, the note 

to be identified. The player then has 6 seconds 

to press the correct key for the note they just 

heard. If they get it right, all the LEDs will flash in 

celebration, otherwise they’re asked to try again. 
As an extension, how about using different, 

selectable instruments? 


[sting _le.py 


pianohat 


pygame 
Signal 


pygame.mixer.pre_init(44100, -16, 1, 512) 
pygame.mixer.init() 
pygame.mixer.set_num_channels(16) 


NOTES = {0:[ ; ]; 
25 | , ]} 
def handle_note( P VE 
channel channel 2; 
pygame.mixer.Sound(NOTES[ channel][1]).play( Q) 


pianohat.on_note(handle_ note) 
Signal. pause() 
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Use the 8x8 grid-animator program 
to create your own exciting 
catchphrase animations 


A Unicorn or 
Sense HAT shop. 
pimoroni.com 


A tall 40-pin 
header (for 
Sense HAT) 
shop.pimoroni. 
com 


Some jumper 
wires, two 
buttons, anda 
breadboard 


The 8x8 grid 
animator 
program 
magpi.cc/ 
2dXmibn 


The Fuzzy Wuzzy 
library 
magpi.cc/ 
2dXlOvH 
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Only three wires are needed 
to connect the Pi to the 
UnicornHAT 


PIPHRASE! 


Make your own version of the popular TV show, Catchphrase. All you need 
are a few components and a LED matrix, in this case the Unicorn HAT... 


atchphrase is a TV game show where 
contestants try to guess the well-known 
phrase or saying being visualised on a big 
screen. In this project, you will be making a similar 
game, using either a Sense HAT or a Unicorn HAT 

to display the animation. We have mainly written 

this project for a Unicorn HAT, but with a little 
modification it can work with the Sense HAT. To make 
the game two-player, we have added some buttons to 
see who is the fastest at guessing the catchphrase. 


>STEP-01 

Put your hat on 

Later on, we will attach a breadboard to use some 
buttons, so we’ll need access to the Pi’s GPIO pins. 
Therefore you shouldn’t just place the Unicorn HAT 
directly onto the GPIO pins; instead, connect it using 
jumper wires. Surprisingly, the Unicorn HAT only uses 
three pins (5V, GND, and GPIO 18), so these are the 
only ones we need to worry about. 


If you have a Sense HAT, remove the header already 
attached and replace it with a tall one instead. This 
should leave some pins sticking out of the top of the 
Sense HAT, which will be enough to attach the wires. 


>STEP-02 


Download the animator 

program and get creating 

When you download the 8x8 grid animator program, 
make sure you use the appropriate one for your HAT. 
If you have a Unicorn HAT, use the command: 


sudo python 8x8grid-unicorn.py 


To create an animation, simply select a colour from 
the palette on the right, and click on a circle on the 
erid to turn that colour on. Add another frame by 
pressing the >> button; this will duplicate the current 
frame. If you need to clear the frame, press the ‘clear 
frame’ button. You can also play your animation on 
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| = 
BD i a 

Z = 5 


= oa 
| 


® 


Mai Uni 
aingame-Untpy 

import unicornhat as uh #import the necessary modules 
import time, random, signal 

import catchphrases uni as cp # the file with our 
animations 

import RPi.GPIO as GPIO 

from fuzzywuzzy import fuzz 


PV ¢ 
=— Ww 
L) i 


def halfthing(num,colour): #turns on half the LEDS to 
indicate who pressed button first 
uh.clear() 
for x in range (num,num+4): 
for y in range(@,8): 
uh.set_pixel(x,y,colour[@],col 
our |; colour}2)|) 
uh. show() 


def pressed(num): # Function to be run when buttons 
pressed 
global running 
running = False # stops animaton from playing 
halfthing(num, (255,0,@) ) 


the LEDs and delete frames. When you are happy 
with your animation, click ‘export to py’ and it will be 


saved as animation8x8.py. 


>STEP-03 


Tinkering with the animations 


You will then need to rename the file (to your own 


choice of name) by using the command line: 


mv animation8x8.py yourchoice.py 


aes ae 


ee 


Right Use the 8x8 uma ed hs ALS _ATS 


grid-animator 
program to create 
your own exciting 
catchphrase 
animations 


oneo Rotate LEDs 
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Clear Grid | 


get_answer(3) # call with goes set to 3 


def b21pressed(channel): # Run when button on GPIO 21 
pressed 
pressed(0) 


def bi6pressed(channel): # Run when button on GPIO 16 
pressed 
pressed(4) 


def get_answer(goes): # Asks the player for their 
answer 
answer = raw_input('Name that catchphrase? ') 
match = fuzz.ratio(answer, picked) # compare 
answer to catchphrase title 
if match >=85: 
print ‘Correct! ' 
elif match >= 60 and match < 85: # if it nearly 
matches 
goes=goes-1 
if goes==0: 
print('run out of goes’) 


You should then repeat step-o2 until you have at 
least three animations. Make sure you rename them 
after each export. 

Now we need to copy the animations into the 
catchphrase code. First of all, open up yourchoice.py 
(or whatever you called it) in IDLE, then find the line 
which has frames=[ on it. Highlight this all the way 
to the final ], then copy and paste it into a new file 
called catchphrases.py. Do the same with the rest of 
the animations and paste them into the same file. At 
the end, you’ll need to use a Python dictionary anda 
list to link the animations to their name; an example 
catchphrases.py is included in the GitHub repository 
for this project. 


>STEP-04 

Connect and test buttons 

To connect the buttons to the Raspberry Pi, you need 
three jumper wires, one breadboard, and two buttons. To 
make the circuit, follow the image on page 55; to test the 
buttons, use the listing1.py code. If using a Sense HAT, 
make sure you use the same GPIO pins (16 and 21). 


>STEP-05 

Fuzzywuzzy matching 

Fuzzy matching is about finding out how close one 
string is to another. Open up a Python shell (either 
using the command line or IDLE) and then import the 
fuzzywuzzy library. 


>>>from fuzzywuzzy import fuzz 
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else: 
print 'Close.. Try again (' +( str(goes) + 
guesses remaining) ') 
get_answer(goes ) 


else: 
print "That's not right" 
print ‘Press “*C to exit’ 
def show_catchphrase(): # Display an animation on the 
LED matrix 
picked = random.choice(cp.ANSWERS.keys()) # Pick 
random animation from file 
for i in range(3): 
for x in cp.ANSWERS[ picked]: 
if running: 
uh.set_pixels(x) # display a frame from 
animation 
uh. show( ) 
time.sleep(@.25) #pause before next 
Frame 
time.sleep(1) # pause before we play animation 
again 


Fuzzywuzzy gives you a score out of 100 for how 
close two phrases are. 


>>>fuzz.ratio( ‘hello world? ,’ catchphrase’ ) 
18 

>>>fuzz.ratio( ‘piphrase’ , ’ pyphase’ ) 

80 


We can use this to check how close the player’s 
answer is to our catchphrase (because we don’t want 
to be too mean!). 


>STEP-06 

The final code 

Now we need to put everything we’ve learned 

together to create the catchphrase game. Type 

the code from the main listing (above) into a file called 
piphrase.py, then run it using: 


sudo python piphrase.py 


PIPHRASE! 


return picked >PYTHON 2.7 


DOWNLOAD: 
magpi.cc/ 
2dXnpBO 


GPIO.setmode(GPIO.BCM) #set GPIO 
numbering to BCM 
GPIO.setup(21,GPIO.IN, pull _up_ 
down=GPIO.PUD_UP) #Set these pins as inputs 
GPIO.setup(16,GPIO.IN, pull up down=GPIO.PUD UP) 
#set callback functions that are run when button 
pressed 

GPIO.add_ event_detect(21,GPIO. FALLING, callback 
b21pressed, bouncetime=300) 

GPIO.add event_detect(16,GPIO.FALLING, callback = 
b16pressed, bouncetime=300) 

ERY: 


running = True # use this to stop animation 
when button pressed 

picked = ‘blank’ 

picked = show_catchphrase() 

signal.pause() #stops the code from exiting 
except Keyboardinterrupt: # catch “c 

exit() #exit the code 


Left This project 
will work with 

a Sense HAT or 
a Unicorn HAT. 
If you're using 

a Unicorn HAT, 
it should be 


connected Like this 


[tingl.py 


import RPi.GPIO as GPIO #import the necessary modules 


The program should make an animation play 
three times on the Unicorn HAT while waiting for 


import time 


someone to press either button. When one of the 
buttons is pressed by a player, their side of the 
Unicorn HAT lights up. They then need to type in 
the catchphrase they think is being shown. The 
program will the tell them if their answer is correct 
or incorrect. The player might also be shown the 
message ‘try again’ if their answer falls somewhere 
between 60 and 80 percent correct according to the 
fuzzy matching. 
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GPIO.setmode(GPIO.BCM) #set GPIO numbering to BCM 
GPIO.setup(16,GPIO.IN, pull up down=GPIO.PUD UP) 
GPIO.setup(21,GPIO.IN, pull up down=GPIO.PUD UP) 


while True: 

print('b1= '+str(GPIO.input(16))+ ' b2= '+str( 
GPIO. input(21) ) ) 

time.sleep(0.1) 
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MAGIC 
PRESENTATIONS 
WITH SKYWRITER 


Amaze your audience with baffling magical powers 
or mastery of the Force using a Skywriter HAT 


118 


Skywriter HAT 
or board shop. 
pimoroni.com 


Skywriter API 


library 
magpli.cc/ 
2dXntBn 


Python AutoPy 
library 
magpi.cc/ 
2dXmbpZ 


LibreOffice 
Impress 
libreoffice.org 


Below You can 
use longer wires 
ora ribbon cable 
to locate the 
Skywriter board 
away from the Pi 
if needed 


et’s face it: simply using a Raspberry Pi to 

run the slides for your talk will make the 
audience think you’re pretty cool. But if that’s 
not impressive enough, why not dazzle them further 
by using your telekinetic powers to flip through the 
presentation and annotate the slides by drawing in the 
aire You don’t even need to be a graduate of Hogwarts 
or the Jedi Academy: just get yourself a Skywriter device 
and some simple Python, and you’re ready to rock. 

The Skywriter device uses a grid of transmitting 
electrodes to generate an electric field that propagates 
around the surface in three dimensions. When you move 
your hand above the Skywriter, it disturbs this field and 
these variations are detected by the receiver electrode 
erid. These measurements can be used to calculate the 
position and movement direction of your hand. 


>STEP-0O1 

Connect the Skywriter device 

If you have a Skywriter HAT, this just connects onto 

the GPIO pins like other HATs. If you have the larger 
Skywriter board, you’1] need to connect six GPIO pins to 
the matching pins at the top, as shown below. 


= 
= 
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>STEP-02 

Install the software 

Make sure you have the latest version of Raspbian, with 
all updates installed. As usual, those helpful Pimoroni 
Pirates supply a single script to handle the installation, 
including the full Python API. Like most HATs, the 
Skywriter needs the I?C bus on the Pi to be enabled, 

so if you haven’t already got this activated on your Pi, 
you’ ll need to reboot before the Skywriter will work. 


curl -sSL get.pimoroni.com/skywriter | bash 


You’ ll also need the AutoPy Python library and its 
dependencies, so install these with: 


sudo apt-get install libxii-dev libxtst-dev 
...and then: 


sudo pip install autopy 


>STEP-03 
Test your Skywriter 


The Python API has example scripts to help you become 
familiar with the way Skywriter works: 


cd Pimoroni/skywriter 
sudo python test.py 


Now wave your hand around in the air just above your 
Skywriter. You should see three columns of scrolling 
numbers corresponding to your hand’s position ina 
three-axis (x/y/z) box over the device. The Python library 
is preconfigured to recognise certain gestures: a flick 
(swiping over the Skywriter), a tap or touch (bring your 
hand down to just above the surface), and, trickiest of 
all, the Airwheel (wiggle a finger in a circular pattern 
above the Skywriter). It takes a while to get the hang 
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of reproducing these gestures so that they are always 
detected, so spend some time practising. You can edit the 
test.py script and comment out the @skywriter.move() 
function (which displays the x/y/z numbers) to make it 
easier to see when you’ve nailed one of the gestures. 


>STEP-04 

Configure your presentation software 

Now it’s time to get your presentation software 

ready. LibreOffice Impress is very similar to Microsoft 
PowerPoint and works well on the Raspberry Pi. If you 
don’t need the other applications in the LibreOffice 
suite, you can just install Impress and the core 
components using: 


sudo apt-get install libreoffice-impress 


You’re going to use Python code to detect gestures 
via the Skywriter and generate keyboard taps to 
control Impress in the normal way. The only extra 
configuration necessary is to activate the functionality 
that lets you draw on slides with the mouse. This is 
done by selecting Slide Show>Slide Show Settings and 
checking the ‘Mouse pointer as pen’ box. 


>STEP-05 

Use the code 

Type up the code from the listing (right) and save it as 
magic_control.py. You can do this using IDLE or with 
another text editor of your choice. Start LibreOffice 
Impress and open your presentation. Then minimise 
Impress and run your code either through Idle or via 
the command line: 


sudo python magic _control.py 


Now flip back to Impress and get ready to start your 
talk or presentation. 


>STEP-06 

Dazzle your qudience 

Start the slideshow by flicking upwards across the 
Skywriter. You can navigate through the slides 

by flicking left to right (forward), or right to left 
(backwards). To end the presentation, flick down 
across the Skywriter. 

To annotate a slide, you need to activate the drawing 
function. Do this using a tap/touch: you’1l now be 
controlling the mouse with your hand movements, 
leaving a trail on the screen just like you’re drawing 
with a pen. This takes practice, so make sure you’ve 
spent some time preparing in advance! When you’ve 
finished drawing, tap/touch again to disengage the 
pen function. 

We all know that, under the pressure of a live 
performance, things can go wrong. If you want to 
quickly disable Skywriter control of the presentation, 
use a double-tap to quit the Python program. 
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Magic_Control.py 


#!/usr/bin/env python 
import skywriter 
import signal 

import autopy 

import sys 


>PYTHON 


DOWNLOAD: 


magpi.cc/ 
2dXnBko 


mouse _down = False 
#work out how big the screen we're using is. 
width, height = autopy.screen.get_size() 


@skywriter.move() 
def move(x, y, Z): 
#print( x, y, Z ) 
global mouse_down 
if mouse_down: # Only run if we're in drawing mode 
= 168) Walshe a 
(y) * height 
scale to screen size 
int (x) 
height - int(y) 


< *<K_ #< 


TECcy > 799"). 
y = 799 


autopy.mouse.move(x, y) 
#print( int(x), int(y) ) 


@skywriter.flick() 
def flick(start, finish): 
print('Got a flick!', start, finish) 


if start == "east": # Back through Impress slides 
autopy.key.tap(autopy.key.K_LEFT) 

if start == "west": # Forward through Impress slides 
autopy.key.tap(autopy.key.K_RIGHT) 

if start == "north": # Start slideshow 
autopy.key.tap(autopy.key.K_F5) 

if start == "south": # Quit slideshow 


autopy.key.tap(autopy.key.K_ESCAPE) 


@skywriter.double_ tap() 

def doubletap(position): 
print('Double tap!', position) 
sys.exit() # Emergency stop 


@skywriter.tap() 
def tap(position): 
global mouse_down 
print('Tap!", position) 
if mouse _down: # Toggle mouse up/dwon 
autopy.mouse. toggle(False) 
mouse down = False 
else: 
autopy.mouse. toggle(True) 
mouse_down = True 


#@skywriter.touch() 
#def touch(position): 
# print('Touch!', position) 


Signal. pause() 
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Solder all your 
components ontoa 
prototyping PCB board, 
once you're ready 


Our simple HAT 
has only one 
component - 
an LED 


Some LEDs 
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To meet the formal HAT 
specification, the board 
must have an EEPROM 


MAKE YOUR OWN 


An EEPROM 

(a CAT24C32 is 
recommended) 
magpi.cc/ 
aRwAaQP 

A breadboard 
and some 
jumper leads 
magpi.cc/ 
aRwAdMt 


magpi.cc/ There are some amazing HATs available to enhance the hardware capability 


aRWAIQi 


The Pi HAT of your Pi. Ever wondered how to design and build a prototype HAT? 


specification 


ee re This tutorial will show you how to get started 


magpi.cc/ 
20OAHaGk 


ATs first arrived with the launch of the 
Raspberry Pi Model B+ in 2014. Since then, 
there have been some amazing and wonderful 
HATs, many of which have featured in previous issues 
of The MagPi: theUnicorn HAT, Piano HAT, Sense HAT, 
and Explorer HAT. Officially, HAT stands for ‘Hardware 
Attached on Top,’ although your expert suspects that 
the acronym came after the name. What else would you 
call an add-on board that sits on top of the Pie 
Although you can manufacture and sell boards that 
don’t conform to the HAT standard, there are many 
advantages in doing so. Having the same physical 
dimensions makes it easy to ensure your board will fit 
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with most Pi cases, and the inclusion of an EEPROM 
allows the operating system to identify the HAT and 
set up any required hardware at startup. 

These instructions will work with either the latest 
version of Raspbian (Jessie) or the older Wheezy. 
As usual, runa sudo apt-get update and sudo 
apt-get upgrade before starting. Then enable kernel 
support for I?C using: 


sudo raspi-config 


Choose ‘Advanced Options’, then tap down and 
select ‘A7 12C’. Make sure ‘Yes’ is highlighted for the 
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WHAT IS AN 
EEPROM? 


EEPROM 
stands for 
‘Electrically 
Erasable 
Programmable 
Read-Only 
Memory’ and 
is a chip used 
in electronic 
devices to 
store small 
amounts 

of data. 


Left Build your 
circuitona 
breadboard or 
Explorer HAT first to 
make sure it works, 
allowing you to 
make changes 


Fig 1 The EEPROM should be connected = . Wy Md i 

answers to both questions. Alternatively, if you’re pe estiesapliedanirtieid aks: odlab | 
If you're not using a 24C32, you may 
using Jessie, you can set this up using the Raspberry Pi need to connect to different pins 
configuration tool available through the GUI. Seni Ne atta Seren DUIS) 
You will then be prompted to reboot. Once your Pi 


has restarted, install the [?C tools package with: eeee 


sudo apt-get install i2c-tools 


Now it’s time to construct your EEPROM circuit on a , 
breadboard. Put together the circuit as shown in Fig 1. ‘ 
If you’re not using a 24C32, you may need to connect —_ 
to different pins for SDA and SCL. Check the data- —E 
sheet for your IC to make sure you get this correct. You 
also need to give the HAT some functionality: in the 
interests of keeping things simple, the circuit of Fig 
1 just contains a tri-colour RGB LED, but you can use 

Fig 2 To test your HAT, make sure you 


whatever components you wish, depending on what reconnect the EEPROM so that it is 


you want your HAT to do. wired to ID_SC and ID_SD. You also need 
to add two pull-up resistors 


ES Fo 28S 4 
= = 4 Ree 


=. 


—= és 
= os 


Power up the Pi. You may notice that the LED is 
already on (perhaps just faintly). This is because the 
Pi doesn’t know what is connected and so the GPIO 
output is ‘floating’. This is something our HAT will 
deal with by preconfiguring the pins that it uses. 
The code snippet overleaf (myoh-rgb.py) provides 
some simple Python for interacting with the LED; 
you’ ll need to install the wonderful gpiozero library to 
use it. 

Next, check to see what I?C devices have been 
detected on the second I?C bus: 


ral 
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i2cdetect -y 1 
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STATIC 
WARNING! 


EEPROMs 
can be easily 
damaged 

by static 
electricity, so 
try to ground 


yourself before 
handling them. 
Ideally, wear 
an anti-static 
wrist strap, 

or at the very 
least leave 

that nylon 
sweater in 

the wardrobe. 


Run the 
prototype from 
the breadboard 
- use the code 


in the code listing 


to test it 


ARBRE | a’ 
we, ; 
ViVi ae 
ey oe | an 

1 yi! Q 

J on " 


THROUGH 


You should see a table displaying the devices found 
on your I?C bus. Assuming you have nothing else 
connected, all but one of the entries should be empty, 
as represented by 2 dashes: — —-. Normally, your 
EEPROM should show up in the leftmost column (0) as 
the number 50, next to the 50 on the horizontal axis. 

If you don’t see this or the command returns an 
error (‘No such file or directory’), try the other bus: 


i2cdetect -y 0 


If your EEPROM still isn’t showing up, check your 
connections and that you have I?C support enabled. 

Now you need some software. Clone the HATs 
reference material and tools from GitHub 
(magpi.cc/10AHaGk). It’s well worth reading this 
documentation, as it explains the thinking behind 
the HAT specification in lots of detail. 

You’re also going to use the handy EEPROM tools to 
flash your chip. First of all, compile the eepmake tool: 


cd hats/eepromutils 
make 


Then modify the eepflash script, which assumes 
that the EEPROM is on the first [?C bus; if yours 
is, then you can obviously skip this step. Copy the 
eepflash.sh and then modify with your favourite 
text editor: 


=) 


7 


122 es The Official Raspberry Pi Projects Book 


cp eepflash.sh eepflash1.sh 
nano eepflash1.sh 


Change all mentions of i2c-®@ to i2¢-1, and 
i2c-@/0-0050 to i2c-1/1-05@0, then save the file. 

Now you need to modify the supplied template with 
your own settings. Open the eeprom_settings.txt file 
in your favourite editor and modify the various fields. 
Most are self-explanatory and you can read more 
about each one in the specification. However, the 
UUID is particularly important and must comply to 
RFC 4122, so that every HAT can be uniquely identified 
and can therefore be used as a per-board Serial 
number. It also allows HATs to be stacked. 

Once that’s done, you need to convert the human- 
readable text file into binary data that can be written 
to the EEPROM. 


./eepmake eeprom_settings.txt eeptest.eep 

Then dump this data to the EEPROM - this is the 
actual flashing bit and you’ll see a warning asking you 
if you’re sure you want to go ahead: 

./.eepflash1.sh -w -f=eeptest.eep -t=24c32 

Make sure you use the version of the script we 


modified earlier. If you’re using a different type of 
EEPROM, change the -t parameter accordingly. 


— 


J 
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Amore advanced step. Solder on a GPIO header and the rest of your 
components using the spec here: github.com/topshed /MYOH 


MAKE YOUR OWN PIHAT | Tutorial 


Slice up some stripboard to the correct 
size for a HAT that fits over the Pi 


To test your new creation, you need to modify your 
circuit so that the EEPROM is connected to the Pi as it 
would be if it were part of a HAT. GPIO pins 27 and 28 
are reserved for HAT detection, so power down your 
Pi again and move the appropriate wires as shown 
in Fig 2. Then add the 3.9kQ pull-up resistors which 
ensure that the pins are not ‘floating’. 

Now reconnect the power to your Pi and let it 
boot. If everything has worked, the directory /proc/ 
device-tree/hat should be present, and the contents 


See what other amazing 
add-ons you can create! 


of its files should match the details in the default 
eeprom_settings.txt file. You should also see that the 
GPIO pins used by the RGB LED have now been preset, 
so it should not be lit at all. 

Congratulations! You have now programmed 
an EEPROM that the Pi recognises as meeting the 
specification for a HAT. 

As a final test, run the myoh-rgb.py code and 
check that the RGB LED flashes through its sequence 
of colours. Clearly, this is a very basic HAT; there are 
loads more possibilities for using the ability to have 
the Pi preload the necessary drivers, so that more 
complicated hardware can be easily supported. The 
Sense HAT is a great example of this technique. 

Now that you’ve made a simple HAT and got to grips 
with the process, see what other amazing add-ons you 
can create! 

If you want to completely follow the whole HAT 
design process, you now have the option to make the 


raspberrypi.org/magpi 


myoh-r gb.py >PYTHON 3 


from gpiozero import RGBLED DOWNLOAD: 


magpi.cc/ 
1aRwCo4o0 


from time import sleep 
led = RGBLED(22, 27,17) 


led.on() 
sleep(@.5) 
led.off() 
led.red = 1 
sleep(@.5) 
led.red =0 
led.green=1 
sleep(@.5) 
led.green = 0 
led.blue = 1 
sleep(@.5) 
led. blue=0 


transition from breadboard to proper circuit board. 
The Raspberry Pi Foundation specification also sets 
the physical properties of the board, right down to 
the radius of the rounded corners and the inclusion 
of slots for the camera and display cables. For 
prototyping, you probably needn’t worry about this 
too much; a simple stripboard design is available in 
the GitHub repository for this tutorial, and is pictured 
in the main image. If you want to take things even 
further, the marvellous Fritzing CAD software has a 
built-in PCB template that can help you produce a 
final design suitable for manufacture. 
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the Raspberry Pi Cookbook and 
Programming the Raspberry Pi: Getting 
Started with Python, among others. 
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Above Watering 
can meets the 
Internet of Things 


PLANT WATERER 


Solve real-world electronic and engineering problems with your Raspberry Pi 
and the help of renowned technology hacker and author, Simon Monk 


Half-size 
breadboard 


12V peristaltic 
pump 


2x male-to- 
female jumper 
wires 


2x male-to-male 
jumper wires 


1k ohm resistor 


MPSA14 
transistor 
(CPC: SC10647) 


1N4001 diode 


DC barrel socket 
to screw adaptor 
(CPC: CN19646) 


12V DC 1A power 
supply (this just 
supplies power 
to the pump) 


Tubing and 
connectors 


his project automates the watering of your 
plants. You can use it indoors to take care 
of house plants while you are away, or with 
a water butt and outdoor containers. 

The interface is used to control the duration and 
start time of your watering, over your local network 
or even over the internet. 
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As you’ ll see from the list of required components 
on the left, this project uses a small circuit built on 
breadboard, and a peristaltic pump to take water 
from your water butt to your containers. 

You can find a pump on eBay, where it will cost about 
£6 from China or twice that from the UK. The pumps are 
intended for use in an aquarium. They consume about 


12V Pump 


MPSA14 Transistor 


MPSA14 Transistor 


300mA, a little too much for an 
old favourite transistor like the 
2N3904, soa MPSA14 Darlington 
transistor, which can cope with 1A, 
is used instead. 
The pumps are usually supplied 
without leads attached, so you 
will probably need to solder leads 
on. If you plan to use the pump 
outdoors, then solder twin speaker 
cable or the like to the pump 
terminals; it must be long enough 
to allow you to have the pump 
outside, and your Raspberry Pi and 
the rest of the electronics indoors. 
The pump needs its own 12V 
DC power supply, which is 
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Plant Waterer This is a pretty straightforward project to build. There are just three 
components on the breadboard. As well as the electronics, you will also 
Start Time: | 22:50 Duration (minutes): 10 ~ need to find a way to attach the pump to your water container and, if it is 


“Set in the open, keep the rain out of the pump. 


Controlling the waterer from a browser 
connected to the breadboard using a DC barrel socket >STEP-O1 
to screw adaptor and two male-to-male jumper wires. 
The tubing and fittings that we used came from a 
low-cost supermarket as a ‘Micro Irrigation System’. 
This packet contained a few metres of tubing as well 


Solder leads 

onto the pump 

Bell wire or speaker cable is 
just fine. To make it easier to 
push the loose ends into the 


as small posts for anchoring the pipes, and small nyaedlaosid Lin (enn wie 

joining sections that were perfect for connecting the solder so that they don’t bunch 

pump to the tubing. up when you try to insert them 
The breadboard, jumper wires, and resistor are into the breadboard. 

probably best bought as an electronics starter kit. 

The Monk Makes Electronic Starter Kit for Raspberry >STEP-02 


Pi includes these parts. Most starter kits for the 
Raspberry Pi will include the breadboard, jumper 
wires, and some resistors. 


Build the breadboard 

When inserting the components 
into the breadboard, make sure 
that you get the transistor and 
diode the correct way around. 
The transistor has one curved 
side that should be facing to 
the left, and the diode has a 
stripe on one end that needs 

to be towards the top of the 
breadboard. The resistor can be connected either way around. 

To prevent accidental shorts between the resistor and diode leads, 
it is a good idea to shorten one or both of the leads. 


SOewvenawn = 


>STEP-03 


Connect the breadboard 
Attach male-to-male jumper wires to the screw terminals of the barrel 
jack adaptor. Use red and black leads, and make sure that you attach the 
red lead to the screw terminal marked ‘+’ Fit the other end of the jumper 
wires into the breadboard. 

perctarS Pump The wires to the pump motor should also now be fitted to the 
Perista Iti c pumps breadboard, and the female-to-male jumper wires used to connect 
the breadboard to GND and 18 on the Raspberry Pi GPIO header. 


Peristaltic pumps use a motor to drive a gearbox that 

in turn drives a pair of rollers that squeeze the flexible 

but strong pipe to push the water through the pump. 
These pumps have the advantage that they are 

‘self-priming’. That is, you do not need to get the 

air out of the intake tube before they start pumping; 

they will eventually pull the water through. The other 

advantage they have is that when the motor stops, 

it effectively seals the pipe, so no water will flow 

through it even if the water is under a bit of pressure. 


Building your waterer 

As with all projects, it is a good idea to test the project 
out and get everything working while the parts are all 
still in your workspace. Once you know all is well, you 
can install the project in its final location. 
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>STEP-04 
Testing 


Before installing the project, 
test it out using two short 
lengths of tube attached to the 
pump and two glasses, one 
containing water. Jump ahead to 
the software section and set the 
start time for a minute ahead 
of the current time. Wait for the 
pump to start, then make sure 
that it will bump water from one 
glass to the other. This will also 
tell you which tube is the inlet 
and which is the outlet. 

Make sure that the tubes 
are really well connected to 
the pump. If any air at all can 
get in, then the pump will not 
work properly. 


>STEP-05 


Installation 

Our example setup is temporary. The Raspberry Pi lives indoors, with the 
lead to the pump fed out through a window. The inlet tube to the pump 
fits under the water butt lid and down into the water. The outlet goes off 
to the plant container. 


Now that the hardware side of the project is complete, 
we just need to get the software running. The program 
is written in Python and uses a library called Bottle to 
provide the web server feature of this project. If you 
made either the Web Door Lock or the Teenager Alarm 
Clock from issues 32 and 33 of The MagPi, you should 
already have Bottle installed. If not, to install Bottle, 
make sure that your Raspberry Pi has an internet 
connection and then run the commands: 


sudo apt-get update 
sudo apt-get install python-bottle 
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‘Waterer_Server.py 


from bottle import route, run, template, request 
import thread, time 

import RPi.GPIO as GPIO 

import datetime 


# Change these for your setup. 
PUMP_PIN = 18 


# Configure the GPIO pin 

GPIO. setmode(GPIO.BCM) 
GPIO.setup(PUMP_PIN, GPIO.OUT) 
GPIO.output(PUMP_PIN, 0) 


# Glogal variables 
start_time = 
duration = 


# Handler for the home page 


Cr) 
def Oe 


You can download the program for this project 
from your Raspberry Pi command line, using the 
command: 


git clone https://github.com/simonmonk/ 
pi_magazine.git 


To run the program, change to the directory where 
the code for this project lives and then run the 
program using the commands below: 


cd /home/pi/pi_magazine/@8_waterer 
sudo python waterer_server.py 


This will start a web server running on your 
Raspberry Pi. You can check this by opening a 
browser window on another computer or your phone 
and entering the IP address of your Pi. Open the 
terminal and type ifconfig to find yours. If all is 
well, a webpage will be displayed, inviting you to 
enter a Start time and duration for the watering. 


How the code works 
The Python code for this program is pretty heavily 
commented. You will probably find it handy to have 
the code up in an editor while we go through it. 
The program starts by importing the Bottle, 
thread, time, RPi.GPIO and datetime libraries 
that it needs. The constant PUMP_PIN is used to 
specify which GPIO pin is to be used to control 
the pump. Change this value if you want to use 
a different pin. 
Two global variables are used: start_time and 
duration. The variable start_time contains the 
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global start_time, duration 
# Change the start_time and duration 


local_start_time = request.GET.get(' start time’, 


if local_start_time != 
start_time = local start_time 


local duration = request.GET.get('duration', '') 


if local duration != 
duration = local duration 


return template('home.tpl', start_time=start_time, 


duration=duration) 


def update(thread_name): 
global start_time, duration 
watering = False 
end_timestamp = 0 
while True: 


# Get the time formatted as a string for comparison 


# with the alarm time 
current_time = time.strftime("%H:%M") 


# If its time to start watering, do so, but not if 


# you are already watering 


time for the next watering to take place; this is in the 
format of a string containing two numbers for the 
hour (24-hour clock) followed by a colon, followed 

by two digits for the minute. The duration is the 
number of minutes that the watering should last. Both 
of these variables will be set using the web interface 
for the project. 


) watering = True 
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if current_time == start_time \ 


qanguage 


and not watering: 


print("Starting Watering") >PYTHON 


GPIO.output(PUMP_PIN, 1) 
end timestamp = time.time() + int(duration) * 62 
# Check to see if its time to stop watering 
if watering and time.time() > end_timestamp: 
print("End Watering") 
watering = False 
GPIO.output(PUMP_ PIN, @) 


time.sleep(1) # allow other threads to run 


# start a separate thread to check the time 
thread.start_new_thread(update, (“update thread”,)) 


# Start the webserver running on port 8@ 
cry: 
run(host="0.0.0.0", port=8@) 
finally: 
print('Cleaning up GPIO') 
GPIO.cleanup() 


Started by the command start_new_thread, 
which causes the update function to effectively 
run independently of the rest of the program. The 
update function checks the current time against 
the start time and if they are the same, it starts the 
watering process by turning on the GPIO pin that is 
connected to the pump via the transistor. 


Since this Python program 1s mostly acting as 
a web server, the code to check the start time 
happens 1n a separate thread of execution 


The next section of the code supplies the web 
interface. Bottle uses the @route directive to indicate 
that the function that immediately follows it is a 
handler for web requests. So the default route page 
of ‘/’ is handled by the function called index. The 
index function uses Bottle’s templating mechanism 
to return the HTML contained in the template file 
called home.tpl. You will find the HTML template 
used in the project contained in the code directory 
for it (bit.ly/1NezVHT). 

When you enter values into the Start Time and 
Duration fields on the webpage, they will be passed 
as parameters when the form is submitted. These 
are extracted in the index function and as long as 
they are not blank (empty-string), they are used 
to set new values of start_time and duration. 

Since this Python program is mostly acting as a 
web server, the code to check the start time happens 
in a separate thread of execution. This thread is 
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The last few lines of the program start up the web 
server on port 80. The try / finally clause is used to 
set the GPIO pins back to inputs when the program 
is quit using CTRL+C. 


Using your waterer 
You can use a web browser on a computer, or ona 
smartphone if it is connected to your Wi-Fi network. 
For this reason, the Raspberry Pi needs to have a 
network connection, which also allows the Pi to 
synchronise with an internet time server. If you find 
that your Raspberry Pi is an hour out, then you may 
need to use the raspi-config tool to set the time zone. 
If you enjoy a bit of web design, the first thing you 
will probably want to do is to add some styling to the 
webpages. The place to do this is in the template file 
home.tpl. If you are network-savvy, then you could 
also set up port forwarding to allow access to the 
waterer from the internet at large. 
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> Encapsulated 
DS1i8B20 
(eBay, Adafruit, 
Proto Pic) 


> 4.7k resistor 
(often supplied 
with DS18B20) 


> Three-way screw 
terminal block 


> 3x female-to- 
male jumper 
wires 


> USB WiFi 
adaptor 


> Small food 
container as 
an enclosure 


> Drill 


UT VLitee. 


WOd'sayeuyuOW 


USB WiFi adaptor 


An accurate DS18B20 
temperature sensor 


Solve real-world electronic and engineering problems with your Raspberry Pi 
and the help of renowned technology hacker and author, Simon Monk 


t this time of year, our roof spaces can get 

pretty chilly and if there are pipes up there, 

there is a chance they could freeze. As anyone 
who’s put a bottle of wine in the freezer to cool and 
then forgotten about it knows, ice takes up more space 
than water and can burst pipes as it expands. This is 
often only discovered when the ice thaws again and 
your bedroom has water dribbling through the ceiling. 

This project monitors the temperature of your pipe 

and uses the If This Then That (IFTTT) web service to 
alert you by email or other mechanism of your choice 


if the temperature falls below a threshold that you set. 


IFTTT is a web service that allows you to set up 
triggers that then cause an action. For example, you 
could create an IFTTT ‘Recipe’ that sends you an 
email (Action) whenever someone mentions you on 
Twitter (Trigger). As well as actions and triggers from 
all sorts of social media and email services, IFTTT can 
also be set up to work with physical events like the 


128 es The Official Raspberry Pi Projects Book 


temperature measured by a temperature sensor falling 
below some threshold. 

The way this works is that the Raspberry Pi sends 
a web request to IFTTT as a trigger and then IFTTT 
performs whatever action you have specified for it. 
In this case, the trigger is to send an email. 

The various channels available to IFTTT often 
require their own logins, so IFTTT will from time 
to time ask you to enter a user name and password 
for a particular channel. 


/\ WARNING! 


Do not rely solely on this project to protect your pipes 
from frost. This is a DIY project intended to illustrate the 
principles of making a temperature monitor and is in no 
way guaranteed to protect your home. 
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DS18B20 1s a digital 
device, accurate to 
+0.5 degrees C D 


As you’ ll see from the list of required components, 
this project does not call for any soldering. The 
leads to the temperature probe are connected to 
the Raspberry PI GPIO pins using a combination of 
electrical terminal block and female-to-male jumper 
wires. You will find the screw terminal block at any 
DIY or hardware store that sells electrical supplies. 


DS18B20 temperature sensor 
The DS18B20 is a sensor temperature chip that is 
available in a standard 3-pin transistor-like package, 
or built into an encapsulated sensor with a long lead. 
In this project we chose the encapsulated version, 
but you could also use the 3-pin package version on 
a breadboard. The chip requires there to be a 4.7kQ, 
resistor between its data and positive supply pins. The 
chip itself will work with 5V or 3.3V logic, but you must 
connect the positive supply to 3.3V when using it with 
a Raspberry Pi to prevent damage to the Pi GPIO pin 
that it is connected to. 

Temperature sensors are often quite inaccurate, 
but the DS18B20 is a digital device that is accurate 
to +0.5 degrees Celsius. 

The IC uses a single GPIO pin on the Raspberry Pi 
using an interface called the 1-wire. Temperature 
readings are sent as serial data to the Raspberry Pi. 


Building your pipe monitor 

As with all projects, it is a good idea to run a test and 
get everything working while the parts are all out on 
your workspace. Once you know all is well, you can 
install the project in its enclosure. 
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This is a pretty straightforward project to build. There is no soldering to 
be done, although if you have a soldering iron, tinning the ends of the 
wires from the sensor leads to make them a bit thicker makes it easier 
to catch them in the terminal block. 


>STEP-01 


Connect female header leads 
Put the red (positive supply), black (ground), and yellow (data) wires from 
the temperature probe into the screw terminal, with the leads of the 
resistor between the red and yellow wires. You may find it helps to wrap the 
bare ends of the wires around the resistor leads before tightening up the 
screw terminals. 
Fit the male ends of the jumper wires into other half of the terminal block. 
Your probe lead may also have a separate bare wire connector to the 
lead’s screening; you do not need to connect this to anything. 


STEP-02 
Connect the temperature sensor 
Connect the positive supply lead to the 3.3V GPIO pin, the black ground 
lead of the sensor to one of the GND pins on the GPIO header, and the 
data lead to GPIO 4. Using a GPIO pin template such as the Raspberry 
Leaf makes it much easier to find the right pins. 

We used a food container that would hold both the screw terminal 
and the Raspberry Pi and drilled holes for the USB power and sensor 
leads. The knot in the sensor lead is to stop the connections being 
pulled off, and the electrical tape prevents the resistor leads 
from accidentally shorting anything on the GPIO pins. 
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>STEP-03 
Start a new recipe in IFTTT 


If you don't have one already, 
create yourself an account on 
IFTTT (ifttt.com). Then click on 
the Create a Recipe button. 


>STEP-04 


Create a Maker Channel Trigger 
Click on the IF part of the new 
recipe and search for the Maker 
Channel in the list of channel icons 
that is shown. Select the only 
trigger option available (Receive 

a web request) and enter the 

text ‘pipe_alert’ into the Event 
Name field. 


>STEP-05 


Choose an Action 
Now we come to the THAT part of 
IFTTT. So, click on THAT and select 
the Email action channel, and then 
select ‘Send me an email’ This 
will use the email address that 
you specified when you signed 
up to IFTTT. 

Complete the action fields. 
The ‘subject’ field will become the email subject, and the body field 
will contain the text of the email. Notice the use of the special names 
contained between {{ and I}. These are called ‘ingredients’ and allow 
you to customise the text. In this case, the ‘OccuredAt’ is a timestamp 
for when the trigger event happened, and ‘valuet' will contain 
the temperature. 


My Becipes Berets (Chancel irosk = 


Create a Recipe 


ifthisthenthat 


eon Wires tarps. eETT 
+ of OB he ies ep erie 


M Complete Trigger Fields 
Recedve a web request 
fal Drmean larre 


pape atest 


Send me an email 


CE) subject 
PwE TEMPTRATY 


RE WARNING 


©) soy 


Aa [|OccurredAt}} the temperature was Velvet B degrees Cl 


0 
So CA OB htes) (econ eyrecers perre oee O@O-s 


Create and connect 


if \ MV then 
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>STEP-06 
Complete the Recipe 


After you have completed the 
Action, you will return toa 
summary of the Recipe. Click the 
Create a Recipe button to actually 
create the recipe and make 

it active. 


Sens Te anens st 
rororkgrs! com 


feupe le 
0 Maker Ever "pipe_alert’. then send me an email at 
wm gmad com 


ee ree ee 
- C @ 6 ewe 


Maker Channel 


>STEP-07 


Find your secret key 
pasonal 9 projects Wh Maker, yuan connects Bad things could happen if just 
ig the Make’ Chanel or share yur ow experiance anyone were allowed to trigger 
\V emails to be sent using IFTTT. 
=< So when the web request is sent 
from Python to trigger the email, it 
must be accompanied by a secret 
key. T To find that key, click on the Channels tab at the top of the IFTTT 
webpage and then find the Maker channel. 


The Mater Chace! allo pou 1 corel TTT oo pour 


In a little while, you are going to need to paste the secret key into your 
Python program. 
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This is the kind of project that you definitely want to 
use SSH for, so that you can connect to the Raspberry 
Pi remotely using the WiFi USB dongle. You can find 
instructions on setting up your Pi to use SSH on the 
official website: magpi.cc/1GULmTr. 

Before you can use the DS18B20 temperature sensor, 
you need to enable the 1-wire interface of the Raspberry 
Pi. To enable 1-wire, edit the file /boot/config.txt using 
the command: 


sudo nano /boot/config.txt 
Add the following line to the end of the file: 
dtoverlay=w1-gpio 


Now reboot your Raspberry Pi and 1-wire should 
be enabled. 

You can download the program for this project from 
your Raspberry Pi command line using: 


git clone https://github.com/simonmonk/ 
pi_magazine.git 


Before running the program, open it with the nano 
editor and change the line: 
KEY = ‘cyR3vPNF1P9K32W4NZB9cd? 


Change this to the IFTTT key that you found earlier. Run 
the program as superuser using the command below: 


sudo python pipes.py 


When you run the program, you should see the 
message ‘Monitoring’ in the terminal, after which 
temperature readings should start appearing. 


How the code works 

The Python code for this program is commented. You 
will probably find it handy to have the code up in an 
editor while we go through it. 

The program starts by importing the libraries that 
it requires: 

glob is used to find the device file for the temperature 
sensor, as the program needs to use wild-card matching 
because every DS18B20 is given a different device ID 
during manufacture; 

time is used for delays; 

url1lib and urllib2 are used to send the web 
request to IFTTT. 

You may well want to change the constants that 
follow this, especially while you are testing the system. 
The variable ALARM_TEMP sets the temperature at which 
an alarm will be triggered, so set this to a few degrees 
less than the temperature reported by the program 
in the terminal and go and get yourself a glass of cold 
water for testing. 
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The constant MIN_T_BETWEEN_WARNINGS prevents 
messages being sent more frequently than once every 
hour. You might want to change this while you are 
testing the project. 

The next set of variables are used to identify the 
location for the file of your particular temperature 
sensor. This will be in the folder /sys/bus/w1/devices/, 
but then the folder name after this will be different for 
every DS18B20. 

The function read_temp reads the content of the 
device file. This will be a two-line message from the 
temperature sensor that looks something like this: 


28 01 4b 46 7f ff 08 10 4c : crc=4c YES, 
28 01 4b 46 7f ff 08 10 4c t=18500 


The number at the start of both lines is the unique 
ID for the DS18B20, and the first line ends in YES if the 
reading was successful, with the temperature being 
reported at the end of the second line as the number of 
thousandths of a degree C. In this case, that’s 18.5°C. 
The function read_temp extracts the temperature value 
from the message and returns it. 

The send_notification function constructs a URL for 
the IFTTT web service, providing the temperature in the 
request body. 

The main loop repeatedly reads the temperature, to 
check if it has fallen low enough to trigger an alarm. 

If so, it calls send_notification and then delays until 
MIN_T_BETWEEN_WARNINGS minutes have passed. 


Using your pipe monitor 

To test the project before you install it, set 
ALARM_TEMP to a couple of degrees lower than the 
ambient temperature, then put the sensor into some 
cold water. After a few moments, the temperature 
readings will start to fall until you get a message: 


TEMPERATURE WARNING 
Congratulations! You’ve fired the 
pipe alert event 


If you go and check your email inbox, you should see a 
notification message. 

Even the power-efficient Raspberry Pi generates 
enough heat to provide a misleading temperature 
reading. To avoid this, make sure that the DS18B20 is 
well away from the Raspberry Pi itself, ideally near or 
even taped to the pipes that you are trying to protect. 
You will of course also need somewhere to connect a 
power adaptor, and make sure that your roof space is not 
out of range of your WiFi router. 

This is a project that lends itself to other tasks. 

You could modify it to just report the temperature at 
regular intervals, or to check for temperatures getting 
too hot rather than too cold. You can also pick other 
actions from IFTTT, such as tweeting or sending 

a Facebook update. 
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PIPE TEMPERATURE MONITOR 


Pipes.py 


import glob 
import time 
import urliiby. urllib2 


ALARM_TEMP = 5.0 # degrees C 

MIN_T_BETWEEN_WARNINGS = 60 # Minutes 

EVENT = ‘pipe alert' 

BASE_URL = ‘https://maker.ifttt.com/trigger/' 

KEY = ‘'cyR3vPNFIP9K32W4NZB9cd' # Place your own key here 


# These constants used by the 1-wire device 
base dir = '/sys/bus/wi/devices/' 

device folder = glob.glob(base dir + '28*')[0] 
device file = device folder + '/wi_slave' 


# Read the temperature message from the device file 
def read temp raw(): 

Ff = open(device file, 'r') 

lines = f.readlines() 

F.close() 

return lines 


# Split the actual temperature out of the message 
def read_temp(): 
lines = read_temp_raw() 
While lines[@].strip()[-3:] !'= "YES’: 
time.sleep(@. 2) 
lines = read_temp_raw() 
equals pos = lines[1].find('t=' ) 
if equals pos != -1: 
temp_string = lines[1][equals_pos+2: ] 
temp_c = float(temp_string) / 1000.2 
return temp_c 


# Send an IFTTT pipe alert event 

def send_notification(temp): 
print ("TEMPERATURE WARNING" ) 
data = urllib.urlencode({'value1' : str(temp)}) 
url = BASE_URL + EVENT + '/with/key/' + KEY 
response = urllib2.urlopen(url=url, data=data) 
print (response.read()) 


print( "Monitoring" ) 
while True: 
temp = read_temp() 
print(temp) 
if temp < ALARM_TEMP: 
send_notification(temp) 
time.sleep(MIN_T BETWEEN WARNINGS * 60) 
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SIMON MONK 


Simon Monk is the author of 

the Raspberry Pi Cookbook and 
Programming the Raspberry Pi: Getting 
Started with Python, among others. 
simonmonk.org 

monkmakes.com 


P| MI-LIGHT 


Solve real-world electronic and engineering problems 
with your Raspberry Pi and the help of renowned 
technology hacker and author, Simon Monk 
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NRF24L01 
2.4GHz wireless 
radio transceiver 
module (eBay) 


Mi-Light RGB 
LED light bulb 


Mi-Light 2.4GHz 
remote control 


7 x female- 
to-female 
jumper wires 


i-Light light bulbs look just like normal LED 
light bulbs and are available at a similar 
price, but they include a 2.4GHz RF radio 
link. This can be used with an RF remote control to 
switch lights on and off, with the lights grouped into 
four zones. The remote control also allows you to 
vary the brightness and colour of the light. Mi-Light 
produces a ready-made module that allows you to 
link the lamps to your WiFi router and then control 
the lighting with a smartphone app. However, by 
using a £3 (S5) radio module connected to a Raspberry 
Pi, you can let your Raspberry Pi take control of 
Mi-Light bulbs in your home, opening up all sorts of 
possibilities for home automation. 

One possible use is to have the Raspberry Pi operate 
as a web Server, providing you with a web interface 
that will let you turn lights on and off from the 
browser of any device connected to your network. 
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Mi-Light LED bulb 


NRF24L radio transceiver 
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This project is based on an original blog post by | © © © / 1) 102.168.1.22/2z0ne=z0n. x \ | Simon | 
Torsten Trankner that you will find in German here: : 
torsten-traenkner.de. The project has only been 
tested on a Raspberry Pi 2, and may need some a 
adaptation for other models of Pi. Lights 

As you’ ll see from the list of required components, 


this project does not involve any soldering. The 


¢ > G@ A [) 192.168.1.22/?zone=zonel&state=off {27 f] @ »| = 


Zone |: | On || Off | 


RF module is connected to the Raspberry Pi using Zone 2:/ On || off | 

female-to-female jumper wires. Even though the 

Raspberry Pi will eventually take over the operation | Zone 3: |_On }|_Off ) Control your home 
of the lights, you do need a Mi-Light remote control | Zone 4: (on )( off | peat ey 


to set things up in the first place. L 


Eid / +8 POW If Aueqdsey 


13 FIju GNO 
19 4j 16 


26 Fa 20 
GND i@wl 21 B+ 


_ a 


You should wire up the RF module with your Raspberry >STEP-02 
Pi powered down, and check very carefully that the Connect the RE module 


COMMEC HONS ale sialic Sete OL Cae lee tes Connect the leads from the RF module to the GPIO header as follows: 
eset act lM! RRL cal a AR nate Pin a (GND) of the RF module to GND on the GPIO header. 

Pe SU MSIL Sela) pc eulaledadl ASCE: Pin 2 (VCC) of the RF module to 3.3V on the GPIO header. 

connections on the GPIO connector. Pin 3 (CE) of the RF module to GPIO 25. 

Pin 4 (CSN) of the RF module to GPIO 8. 

Pin 5 (CLK) of the RF module to SCLK (GPIO 11) on the GPIO header. 
Pin 6 (MOSI) of the RF module to MOSI (GPIO 10) on the GPIO header. 
Pin 7 (MISO) of the RF module to MISO (GPIO 9) on the GPIO header. 


>STEP-03 

Pair the Mi-Light 

For this step, you will need to 
plug your light bulb into an 
appropriate light socket. Then 
turn on the normal light switch 
and immediately press the On 
button for one of the four light 


>STEP-0O1 
Attach leads to the RF module 


Start by connecting jumper wires to the RF module s- bas ‘ | zones on the Mi-Light remote. 
using the wiring diagram as a reference. You will need ; \ . ‘S | The lamp will blink three times 
connections to every pin except the pin in the bottom \ $ 5 as confirmation. Once paired, 
right of the connector (pin 8). Using leads of the same ‘ 0 9° = the remote will be able to turn 
colour as the wiring diagram will help you make the hal | the light on and off and make 


correct connections. other adjustments. 
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This project requires quite a lot of software setup 
before you can go ahead and use it. 

The radio module uses the Raspberry Pi’s SPI 
interface, which needs to be enabled, so run raspi- 
config using the command: 


sudo raspi-config 


Scroll down to the Advanced option, select it, and 
then select SPI. Enable it, and when asked if you want 


This code 1s all in C++ but can be 
called from our Python program 


the SPI module to load automatically, say Yes. 
Next, you need to install and build the NRF24 library 
for the RF module by issuing the following commands: 


git clone https://github.com/TMRh20/RF24 
cd RF24 

make all 

sudo make install 


After that, you need to download a messaging 
library that provides a higher-level interface to the 
basic RF module using the following commands: 


cd .. 

git clone https://github.com/mysensors/Raspberry 
cd Raspberry 

make 

sudo make install 


Below Turn light 
zones on/off from a 
phone browser 


Now download the code that Torsten Trankner wrote 
using the following commands: 
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cd .. 

wget http://torsten-traenkner.de/wissen/ 
smarthome/openmilight_raspberry_pi.tgz 

tar xzvf openmilight_raspberry_pi.tgz 


This code is all in C++ and so that we can make use 
of it in Python, your expert has written a C++ program 
called send_cmd, which is designed to be called from 
Python with a command message to be sent to the 
Mi-Light. Download this program and the Python code 
for the project from your Pi’s command line, using: 


git clone https://github.com/simonmonk/ 
pi_magazine.git 


Copy all the files in the project folder 11_m1_light 
into the openmilight folder, and then compile two of 
the programs by using the commands: 


cp pi_magazine/11_mi_light/* openmilight 
cd openmilight 
sh ./comp.sh 


You also need to install the Python Bottle library that 
will be used for the web server, using the command: 


sudo apt-get install python-bottle 


Before you can run the main program, you need to 
find the ID of the Mi-Light remote that you used to 
pair with the Mi-Light so that your Raspberry Pi can 
impersonate it. 

Run the program openmilight using the command 
below, and then press the On button for Zone 1 on 
the remote a couple of times. Each time you press 
the button, you should see a stream of hexadecimal 
number like the ones in the example below. 


sudo ./openmilight 
in listening mode 
BO Al 56 41 C1 03 72. 
BO Al 56 41 C1 @3 73. 


The first three digits (in this case Bo, A1, and 56) 
will be different for your remote, so quit the program 
using CTRL+C and edit the file lights.py, changing the 
value of the ID variable at the top of the file to be the 
three hex digits for your remote. 

Finally, you are ready to fire up the web server using 
the following command: 


sudo python lights.py 


Point a convenient web browser at the IP address of 
your Raspberry Pi and you will see a webpage with On 
and Off buttons for all four zones. Click the buttons 
for Zone 1 and you should be able to turn all the lights 
connected to that zone on and off. 
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Ughts.py 


bottle import route, run, template, request 
import os 


ID = 'BO Al 56' 


MIDDLE = ' @6 C9 '' 

ZONES = { 
“Zonel, p> 4 7on- = “02°, Ota = 04"), 
"zone2': {'on': '@5', ‘off': '@6'}, 
“zones : {on : ~O7", Ofr 2 Os: },; 
‘zones’: {°on': “09°, “oft ; OA" }} 


def light_on(zone): 
print(zone + "on") 
send(ZONES[ zone][ ‘on’ ]) 


def light_off(zone): 
print(zone + "off") 
send(ZONES[ zone][ ‘off’ ]) 


How the code works 
You will probably find it handy to have the code up in 
an editor while we go through it. 

The program starts by importing the bottle and 
os libraries. The os library is needed to invoke the 
send_cmd C program from Python. 

The constant ID needs to be set to the three hex 
digits for your remote, as described earlier. The codes 
in MIDDLE do not need to change. Note that the spaces 
in both these constants must be kept as they are, so 
that when the hex message is constructed, there are 
spaces between each hex digit. 

The Mi-Light remote control allows up to four zones 
to be defined, and you can attach multiple lights to 
each zone. There are separate On and Off codes that 
control each of the zones independently. These are 
stored in the variable ZONES, which is a dictionary or 
dictionaries, making it easy to look up the appropriate 
hex code for the command you want. 

Two functions (Light_on and light_ofFf) switch all 
the lights on or off for the zone name specified as their 
parameter. Both these functions use the send function 
to actually send the command to the RF module via 
the C program (send_cmd). The send function first 
constructs a message string by concatenating the ID, 
MIDDLE section, command code, and finally @@ into 
a message string. The C program is then called five 
times, passing the message as a parameter. Since it can 
be a little unreliable, sending the message five times 
makes it almost certain to get through to the light bulb. 

Next, there is the web server part of the code, 
contained in the index function. This expects the 
webpage to provide two request parameters: the zone 
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Pl MI-LIGHT 


from 
def send(code): 
global ID, MIDDLE 
for i in range(1, 5): 


DOWNLOAD: 
magpi.cc/1NZhcLv 


message = ID + MIDDLE + code + 
' 99" 

os.system('./send_cmd "' + 
message + ‘"') 


# Handler for the home page 
@route('/') 
def index(): 
zone = request.GET.get('zone', ‘zone1') 
state = request.GET.get('state'’, ‘off') 
if state == ‘on': 
light_on(zone) 
else: 
light_off(zone) 
return template(‘home.tpl' ) 


# Start the webserver running on port 8@ 
run(host="0.0.0.0", port=80) 


name (zone) and whether it is to be turned on or off 
(state). This information is then used to call either 
light_on or light_off. At the end of the index 
function, the contents of the template home. tpl 
are returned, to provide the browser with the HTML 
for the web interface. 

The final line of code starts the web server running. 
Switch over to a browser on the Raspberry Pi, or 
another computer on your network, and type the IP 
address of your Pi into the address bar. To discover the 
IP address of your Raspberry Pi, type the command 
below into LXTerminal: 


hostname -I 


It will be at the start of the response as four 
numbers separated by dots; for example, 192.168.1.22. 


Using your PiMi-Light Controller 

As well as controlling the lights from the browser on 
your computer, you can just as easily use the browser 
on your smartphone, as long as it is connected to the 
same network as your Raspberry Pi. 

You could also adapt the alarm clock program back 
in issue 33 of The MagPi to turn the lights on and off at 
certain times. 

This project simply turns the lighting on and 
off. Considerable work has been done in reverse- 
engineering the Mi-Light protocol to figure out what 
all the codes do. So, if you want to extend this project 
to adjust the colour and brightness of the lights, 
then you might want to look at Henryk Plotz’s work: 
magpi.cc/1NZfcmt 
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Tutorial WALKTHROUGH 


> Raspberry Pi 
with 40-pin 
GPIO header 


> Sense HAT 
or Pimoroni 
Unicorn HAT 


> USB WiFi 
adaptor or 
Ethernet 
connection 


Solve real-world electronic and 
engineering problems with your 
Raspberry Pi and the help of 
renowned technology hacker 
and author, Simon Monk 


his is avery simple project to make. In fact, 
all you really need to do is plug the Sense or 
Unicorn HAT onto the Raspberry Pi’s GPIO 
header and install the software. 
This project displays the current time in binary. 
The rows of the display are (from top to bottom) the 


last two digits of the year (e.g. 15), the month number, 


the day of the month, the hour (24-hour format), 
the minute, the second, and finally hundredths 
of a second. 


Reading the binary clock 

To read a binary clock, you either need to be good 
at recognising binary numbers or use a bit of 
arithmetic to calculate the time, by adding up the 
binary digit values for the LEDs that are litona 
particular row. 

For example, the first row displays the year in two- 
digit format. So, if LEDs at positions 8, 4, 2, and1are 
all lit, then the year is 8+4+2+1 = 15. In 2016, just the 
digit position 16 will be lit. 

The colours of the LEDs have no significance — they 
are different to make the display more interesting. 

If you’re using the Sense HAT, you may need 
to install the software for the HAT using the 
following commands: 
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sudo apt-get update 
sudo apt-get install sense-hat 
sudo pip-3.2 install pillow 


If you’re using a Unicorn HAT, then run the 
following commands: 


sudo apt-get install python-pip python-dev 
sudo pip install unicornhat 


There are two versions of the software for this 
project — one for the Sense HAT and one for the 
Pimoroni Unicorn HAT - so be sure to use the right 
version of the program for your hardware. The Sense 
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USB WiFi adaptor 
for internet time 


Sense or Unicorn HAT 


HAT version is called binary_clock_sh.py, and the with this project (12_binary_clock): 
Unicorn version binary_clock_un1.py. 
You can download the programs for this project git pull 
from your Raspberry Pi command line using 
the command: To run the program, change to the directory where 
the code for this project lives and then run the 
git clone https://github.com/simonmonk/ program using the commands below: 


pi_magazine. git 


cd /home/pi/pi_magazine/12_binary_clock 


This command will actually bring down the code sudo python binary_clock_sh.py 
for all the projects in Simon’s The MagPi series, so if 
you’ve already issued this command for one of the Or, if you are using the Unicorn HAT: 
earlier articles, change directory to pi_magazine and 
run the following command to update your directory sudo python binary_clock_uni.py 
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001110101001010010101000010111010100110101101010C 


J1011010100101001110101001010011101010010100101010 


binary_clock_unt.py 


#!/usr/bin/env python binary_str = “{0:8b}”.format(value) 
for x in range(@, 8): 
import unicornhat as hat if binary_str[x] == ‘17; 
import time, datetime hat.set_pixel(x, row, color[@], color[1], color[2]) 
else: 
year color = (@, 255, 0) hat.set_pixel(x, row, 9, 9, @) 
month_color = (@, @, 255) 
day color = (255, @, 9) while True: 
hour color — (0; 255. 0) t = datetime.datetime.now() 
minute_color = (@, @, 255) display binary(t.year % 100, 8, year_color) 
second color = (255, @, Q) display _binary(t.month, 1, month_color) 
hundretths ‘collor = (127, 127, ©) display _binary(t.day, 2, day_color) 


off = (0, 2, @) 


hat.clear() 
hat.brightness(0@.5) 


display binary(t.hour, 3, hour_color) 

display _binary(t.minute, 4, minute_color) 

display _binary(t.second, 5, second color) 

display binary(t.microsecond / 10008, 6, hundrefths_color) 


hat. show( ) 
def display binary(value, row, color): time.sleep(@. 2001) 
64 32 16 8 
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binary_clock_sh.py 


#!/usr/bin/env python 


from sense hat import SenseHat 
import time, datetime 


hat = SenseHat() 


year_color = (@, 255, 0) 
month collor = (0, 0, 255) 
day color — (255, ¢, 90) 
hour color = (6, 255, @) 
minute_color = (@, @, 255) 
second color = (255, @, Q) 


hundrefths_ color 
or = (0. 0, 0) 


(127.127, @) 


hat.clear() 


How the code works 

The two versions are actually very similar to each 
other. Both start by importing the libraries that 
they need for their displays. They then define a 
number of colour variables that you can change, if 
you like, in order to set different colours for each 
row of the clock. 

Most of the action takes place in the 
display_binary function. This takes three 
parameters. The first is the value to be displayed 
as binary, the second is the row on which it should 
be displayed (0 to 7), and the final parameter is the 
colour to be displayed. 

The value is converted into a binary string 
representation using String’s format function. 
The for loop then iterates over each column 
(x value) and if that digit contains a1, turns on the 
pixel in that row and column to the colour specified, 
otherwise the pixel is cleared. 

The main loop fetches the current time and then 
Splits it into its component parts, displaying each 
on a Separate row. To display the year in two-digit 
format, we use modulo 100 (t. year % 100), which 
is the remainder after dividing it by 100. 


Using your binary clock 

Having a keyboard, mouse and monitor attached 
to your clock is fine while you are constructing it, 
but it would be better to have the program start 
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1010011101010010100111010100101001010100001011101 
00010111010100110101101 


BINARY CLOCK | Tutorial 


010010100111010100101001110 
qanquage 


>PYTHON 
DOWNLOAD: 


magpi.cc/1P1182I 


def display binary(value, row, color): 
“£0:8b}”. format (value) 
for x in range(@, 8): 


binary_str 
if binary_str[x] == ‘17’; 
hat.set_pixel(x, row, color) 
else: 


hat.set_pixel(x, row, off) 


while True: 


t = datetime.datetime.now() 
display _binary(t.year % 100, ®, year_color) 
display _binary(t.month, 1, month_color) 
display _binary(t.day, 2, day_color) 
display_binary(t.hour, 3, hour_color) 
display _binary(t.minute, 4, minute_color) 
display_binary(t.second, 5, second_color) 

display _binary(t.microsecond / 10008, 6, hundrefths_color) 


time.sleep(@.2001) 


The two versions are 
actually very simular to 
each other. 


automatically when the Raspberry Pi first boots up. 
To do this, run the following command to make the 
program executable: 


sudo chmod +x binary_clock_*.py 

Then, edit the file /etc/rc.local with the command: 

sudo nano /etc/rc.local 

Add the following line after the first block of 
comment lines that begin with #. Change the line to 


the _uni version if you are using a Unicorn HAT. 


sudo /home/pi/pi_magazine/12_binary_ 
clock/binary_clock_sh.py & 


Restart your Raspberry Pi and this time the 
program should start up automatically. 

Note that you will still need an internet connection 
for the Pi to pick up the correct time. 
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feature 


RASPBERRY PI 


e’d like you to pick 

up the Raspberry Pi 

Zero that came with 

The MagPi 40. You’re holding 

in your hands a fully functional 
computer that’s going on sale 

for $5 and that you could lose ina 
small purse. It’s quite the amazing 
feat of engineering and we’ re very 
excited to bring it to our readers, 
along with many pages of content 
that will take you from a Zero 
Novice to a Zero Master. 

Over the course of our expansive 
coverage, we talk to the people 
behind the Raspberry Pi Zero’s 
development, teach you how to 


ZERG 


A new revolution in 
computing is upon us 


eoecer reece eee reece eee eee eee eee eee eee eo ele eee e 


: MicroSD card 


: slot for storing 
hook it up, and also aUgseo some : the operating 2, 
great uses for your Zero. With : 
: . - system, files, 
its even smaller size, there are is 
: and documents 
some amazing things you’ll be 
: pC e 
able to do with it. Check Out ne ee eee . ono0dgOODa 3° 
the contents at the start of ® 
this section to get an idea 
of what kind of incredible 
things we’re about to do vee 
with the Pi Zero. how gine por ae 
: for digital sound Rie 
> and 1080p video . 
— 
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RASPBERRY PI ZERO 


; 40-pin : Unpopulated ; Unpopulated 

: unpopulated : RUN mode pins : RCAcomposite 

: GPIO port for > which can be : video out pins so 
; connecting to : usedtoadda ; you can connect 
: your electronic : reset button to ; toanoldTV 

: circuits : the Pi Zero : 


: Asmaller camera 

: connector port 

; toconnect a Pi 

: Camera Module to 


: Power and 

: activity LED - this 
: lets you know the 
: PiZeroisonand 

: working away 


eoeeececer oe reece cece er eee eee eee ee ee 


_. ee EO NEOROERT | ; Micro-USB port 
: for power — the 
; same kind that 
; charges Android 
mobile phones 


Ce 


“ 


| THE SPECS 


CPU: BCM 2835 (same as the original 


oe Raspberry Pi), 1GHz single core ARM11 
3 RAM: 512MB 
7,°° : Storage: Via microSD 
7 : : Power: Micro-USB connector 
: Broadcom BCM : Micro USB 
: 2835 system- : Port for Video out: Mini-HDMI 
: on-a-chip, the : connecting 
ne ap eg eaoces, Connectivity: 1x micro-USB, unpopulated 40-pin GPIO 
: that powered - mice, WiFi, : : 
cineonainel : USB sticks, connector, camera port, unpopulated Composite Video Out 
: Raspberry Pi : and more ee ae ee ee a ee Po at 
Dimensions: 65mm < 30mm <x 5mm. Weight: 9¢ 
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Feature | ZERO UNBOXED 


Let’s takea 
closer look at 
this miniature 
Raspberry Pi 


ZERO 
UNBOXED 


- . 
‘ : s 
a 

a = 

ro 


} EB ‘ == Ft 
4L a a oe Teen ev 
~|GPIO 7 it < 


“~~ 
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ee age ll 


~- wee eres : 
eed SIE (G31 


eae 
ee 


You’ll need a microSD * Amini-HDMItoHDMI cable : This micro-USB port is for . This is the power jack - 
card so you can actually * is required to hook up a * data; to actually use it to plug . don’t get it mixed up with 
give the Raspberry PiZero ° monitortothe Raspberry Pi : inamouse, keyboard, ora . the data port! You’ll need 
an operating system. ° Zero-anormalHDMI cable : wireless dongle, you’llneeda . amobile phone charger, or 
Some come with SD > will not fit. > micro-USB to USB adaptor. - one of the official Raspberry 
adaptors soyoucan plug ; : . Pi power supplies, to turn 
it into your PC. : ; ; the Zero on. 

= 

= a"1 fo) oT fo) 
| 0 = HL cle<elloc) : HL ole 
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ASSEMBLE 
YOUR ZERO 


It’s simple enough to put your Raspberry Pi 
Zero together — as easy aS 1, 2, 3, in fact... 


= 3 ele CINe 
PLUG IN SD CARD 


You'll need to install NOOBS (New 
Out Of Box Software) onto your 
Raspberry Pi Zero, enabling you to 
choose an operating system. Plug 
your microSD card into another 
computer and visit the Raspberry 
Pi download site (magpi. 
cc/1MYYTMo). Download Raspbian 
and install it via a card writer as 
described in our getting started 
guide. Pop it in once its written. 


J 
5 


Usa 
STE 


‘ 
ap 0 
) 
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> STEP Tia 
CONNECT CABLES 


Plug in the mini-HDMI to HDMI 
connector and make sure it’s 
properly connected between the 
Raspberry Pi Zero and your display. 
Now plug in your USB adaptor, 
making sure it’s in the correct 
micro-USB port, and attach your 
USB hub. You may not need a hub 
with external power, but make sure 
one is handy just in case. 


> © MS ae ie ite tienes 
POWER IT UP 


Plug the power cable into the 
micro-USB power socket, again 
checking to make sure it’s the correct 
one - at this point it should be the 
only one left. Plugging the other end 
of the power supply into a wall socket 
will immediately turn the Raspberry 
Pi Zero on. You’re now ready to start a 
new chapter in hacking and making! 
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RASPBERRY PI ZERO 


GRAB YOUR 
CABLES 


Don’t have a mini- 
HDMI or micro-USB 
converter°® We’ve 
got you covered... 


We understand the cables 
required to get your Raspberry 
Pi Zero hooked up are not 
particularly common; although 
you might have a mini-HDMI 
cable if you bought a really nice 
camera in the last few years, the 
micro-USB adaptors are much 
less common. With that in mind, 
Raspberry Pi has put together a 
cable bundle that will help you 
get your Zero working in no time. 


Just head over to the Swag Shop These two 
special cables 
allow the Pi Zero to 
bundle today! be teeny-tiny 


(swag.raspberrypi.org) to geta 


RASPBERRY PI 


a eS Se EE ee . = 
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‘Feature | REMOTE ACCESS 


FRooEN TIAL 


Le*t To seta static 
IP on the desktop 
interface, you'll have 
to go through the 
same process 


network={ 
ssid=”YourSSID” 
psk=”YourWifiPassword” 
I 
You can also give the Raspberry 
Pi a static IP. To do this, you first 
While Raspbian makes it deadeasy need todo some prep work which 


> to connect to WiFi on the desktop requires you to use a computer 

> interface, there’s a little more which is already connected to 

; involved in getting it working your wireless network. Open the 

* from the command line. Before command line in Windows or 

; we begin, there is one trick you the terminal in OS X or Linux. 

; can do: if you set up the WiFi at For Windows, type ipconfig; for 
4 ; the desktop, it will still work while OSX and Linux, use ifconfig 
OQ. ; inthe command line. That isn’t followed by netstat -nr. Note 
> . always possible, though, so you the IP address (inet), the broadcast 
‘ag . may need to use the manual way. address, the subnet address, 
ag : First, find out the name of your the router IP (Destination), and 
A . network and the password. In the Gateway address. After that open 
aa . Raspbian command line, type: the DHCPD conf file (sudo nano / 
‘ah Pp yp 

; sudo nano /etc/wpa_ etc/dhcpcd.conf) and add: 
< » supplicant/wpa_supplicant. 
ag . conf. There will already be some interface wland@ 

. information but to get the wireless 
ine oncone to conmiest, make sute the file has static ip_address=[address] 
versionsof  —._— these lines in it, with your network static routers=[router IP] 
muha 926 (OID andl ito pacers static domain_name_ 
itmayalreadybe . ; 
installed - replacing what’s already here: servers=[ gateway | 


Ss 
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THE RASPBERRY PI ZERO 


USE YOUR RASPBERRY PI 
FROM ANOTHER COMPUTER 


SHARE FILES ON YOUR 
NETWORK WITH SAMBA 


Thanks to a piece of software called 
RealVNC, you don’t even need to 
plug your Pi Zero into a monitor 

to use its desktop; you can simply 
control it from another computer. 
First of all, go to magpi.cc/PiIVNC 
and download RealVNC onto your 


This is especially good if you want to use your 
Raspberry Pi Zero as a file server. For this, or just 
generally to be able to access the files on your Zero 
from anywhere on the network, you’ ll need to 

use Samba. First, you need to install it: 


sudo apt-get install samba samba-common-bin 


Raspberry Pi. Also obtain a free 
licence key (magpi.cc/108Hz4J), as 
you'll be needing it. 

Once the file is on your Pi, 
open the terminal, use cd to 
navigate to the file in Downloads 
(cd Downloads should do) and 
use the following two commands, 
replacing the square brackets with 
the appropriate names: 


tar xvf [VNC file name]. 
tar.gz 

sudo dpkg -i [VNC Server 
package name].deb [VNC 
Viewer package name].deb 


Copy the licence key you got 
and then run sudo vnclicense 


On some versions of Raspbian, Avahi 
may already be installed 


-add [License Key] with your 
key. Type vncserver into the 
terminal or command line for it 

to begin, type in your Raspberry 
Pi’s password (it’s raspberry by 
default) and make a note of the 
display number. In our case it was 
1, and as Avahi was installed, we 
can connect using raspberrypi:1. 


Install a VNC viewer from 
here: magpi.cc/1M4uzfG 
on your platform of choice, 
and then connect with: 
raspberrypi: [Number ] 


ACCESS YOUR PI REMOTELY FROM 


THE COMMAND LINE 


Via the SSH protocol, you can access 
the Raspberry Pi from any other 
computer on your home network. 
SSH should be activated by default, 
but to make sure it is on, you can go 
to Raspberry Pi Configuration from 
the Preferences category in the Menu 
(or by typing sudo raspi-config 
from the command line) and ensure 
SSH is turned on in the Interfaces tab 
(or under the Advanced menu in the 
command-line version). If SSH was 
disabled, enable it and reboot. 

In OS X and Linux, you can use SSH 
from the terminal; in Windows, 
however, you’ll need to download 
PuTTY (magpi.cc/i1Mm5Npi). 
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From an OS X or Linux terminal, you 
can access the Pi remotely with: 


$ ssh pi@raspberrypi 


You will need to set up a network 
name (see box on previous page). 
Type yes to trust the connection, 
then enter the password raspberry to 
log in. If using PuTTY, just type pi@ 
raspberrypi into the address field 
and click Connect. Again, you’ ll have 
to agree to trust the Pi Zero, then use 
the password raspberry. 

You can now control the Raspberry 
Pi in as you would normally do via 
the command-line. 


You need to configure Samba to work as intended. 
Still in the terminal or command line, type: 


First of all, if you have a Windows workgroup with a 


sudo nano /etc/samba/smb. conf 


specific name on your network, find the line starting 
workgroup = WORKGROUP and change the uppercase 


WORKGROUP to your workgroup’s name. If you 
have no idea what a workgroup is, you can leave 
this setting alone. Find the line # wins support 
no, delete the # character, and change the no 

to yes. Scroll down to the section labelled Share 
Definitions and enter the following chunk of code: 


[ pihome ] 
comment= Pi Home 
path=/home/pi 
browseable=Yes 
writeable=Yes 
only guest=no 
create mask=0777 
directory mask=0777 
public=no 


Press CTRL+X, then Y and ENTER to save the file. To 
start the sharing, enter the following in the terminal 


and use your Pi’s password (raspberry by default): 


smbpasswd -a pi 


The configuration file looks complicated, but you only need 
to change a couple of bits! 
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feature | MORE #PIZERO PROJECTS! 


s there’s a bit of a = 
- Raspberry Pi Soren now, 
when new gear comes out ~ 


a's 


there’s a much faster reaction when - 
making new accessories for it. Even” : 
though the Raspberry Pi Zero is only 
a few months old, this means that ~ 


Keep your Pi Zero in style 
with these trendy cases 


magpi.cc/1KlgEiu 
A matte black, laser-cut, layered 
case for the Raspberry Pi Zero. This ~ 
keeps access.open.to the four main 
ports to get the Zero working (HDMI, 
SD, USB, and power), as Well as 
keeping the GPIO: pins free. 

Even the reset and 


accessible 


146 eT The Official Raspberry Pi Projects Book 


ee “there'a are aya) FS accessories | -— i 
* you can get your hands OM:tO. = 2:28. 
improve your PL Zero experience. 
There’s also a bit of kit you'll neéd = 
to make some of the projects in this 
zs issue, and even start making your | 
roe own incredible builds: va 


video out pins are — 


through it. ~ 


= magpl. Cc/1KIjtOz 
_ Aspecial Pi Zero version of the classic 
"__ laser-cut Pibow is already available. - 
- With its unique; chip- hugging design, 
it leaves the ports very. open for use 


with any custom projectand even 


some of the Pimoroni HATs - - although 
you ‘lL have to insert the SD card 
‘before construction. 


i magpi. cc/ 2dXqMZo : 
_ Asturdy case made up of two layerso of 
__. wood along with a thick acrylic centre, sae 
: the Zebra Zero.adds.a touch of class” 
to your Raspberry Pi Zero. It also has. 
amassive heatsink, which may be. a 


little superfluous. You can also get a a5 


| é Zebra Zero Plus with a full breadboard | 
i attached is Suny testing: 


ie magpi. cGy 1ZEZbhn 
‘“Amuch simpler case than the others a 


featured here, the Protector covers 


; the bottom and part of the top of | 
~ the Pi Zero, not quite offering the 
full protection of its rivals. It does, 


however, have more space 
’ open around the GPIO than 
others, allowing for : 
greater access to 
it in case you | 
have tight 
space in 
your project. 
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Other bits and pieces to improve your Raspberry Pi Zero 


#PIZERO ACCESSORIES 


BD RIGHT-ANGLE 
i GPIO HEADER 


There are a few of these available: 


= we’ ve had some success with the 
meZmory brand, one, but there. are. 


ee We's ve shown you — to solder a 
oe standard GPIO header to the Pi Zero, 


: several others. It makes plugging: 


-in'single USB devices to the Pi Zéro i 


| much easier — great for projects - 
that just requite wireless and. 


a S: nothing else. 


but this cool alternative allows for 
_. "the GPIO pins to be parallel with the. 
| board. This can be ideal for awkward 
‘ projects or installations where | 
* ‘Space restrictions: are. BES 
- fixed, and it solders: = oe 
“in like any other. Ss ae . 
ste header: — 


# ESSENTIAL RASPBERRY [ll SCROLL PHAT 


PI ZERO KIT 


~ This actually works on other 


A nice selection of components that ‘Raspberry Pis as Well, but it's 


can be used with the Raspberry 


- Pi Zero , including extra adaptors, 

~ .several.GPIO header options, and — 
even little stick-on feet ) raise the | 
Pi Zero off the ground. It all-comes 


ina little mint-like tin Wiattela can 
~ also fit the 


whole Pi zero have itscroll. : 
Zero fora Essentials Kit text across, : speek ct 
makeshift the length of .- SESGEERREER 


carry case... 


/EXPLORER PHAT 


This add-on board for the Zero | 


(and other Pis) allows it 
to communicate with 
different objects more 


: SIGoTIoonoooose 
Gocosessoes. Ptetetst=latsts| 


“designed i inthe same form factor as 
the Pi Zero. This board gives you 55 : 
LEDsina rectangular formation and 
works similarly to the LED matrix on 

_the Sense HAT. Using a Python script, 
you can control — i 


the LEDs or LEELEE LL) Lees 


\_| GEEEEEEEEEE 
C ESGEEREESES 


sensors — we've seen Explorers used 
~~. in robots due to this. It allows 


JILIN: f@r analogue inputs as well as 


other inputs and outputs, and 


easily than wiring them ~ satan : has.its.own Python library for 


directly to the Pi. This 
includes motors and 


> 
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= =# quick development. Great for 
a = tiny projects. 


the board. - GBRBREEREEEE = 


- = So SCROLL PHAT Se 


ESSENTIAL KIT 


You'll need these basics to create 
amazing Pi Zero projects 


Components 

LEDs, wires, resistors, and maybe even 
some light, heat or motion sensors. All 
of these are available for very cheap in 
bundles from a local electronics store, 
or online from a distributor such as RS 
Components. You can also get a lot of 
them in an electronics starter kit, like the 
one pictured from 

ModMyPi (magpi.cc/ 

1RvzWta). For the 

tutorials in this issue, 

we'll make sure you 

know exactly what sort 

of components you 

need before you go 

out and buy them. 


Soldering iron 

An important piece of equipment for making 
more advanced projects, or building some 
kits available for the Raspberry Pi. As well as 
the actual soldering iron, you'll need good 
quality solder to work with. A decent stand 
for the soldering iron is also ideal - one that 
you're not likely to 

burn yourself with, 

containing a good 

sponge. Soldering 

can be dangerous, 

so make sure to 


. supervise younger 


makers when 
they're building. 


Breadboard 
A perfect tool for prototyping and testing 


. your circuits. If you've never used a 
' breadboard, what it does is give you a load 


of pins that are aligned in columns, acting 
as connectors so you don't have to solder 
components together. This means you can 
quickly change a circuit to get it right, or 
reuse the breadboard 
over and over again 

for new and different 

circuits. You probably 

don't need to start 


~ with a massive one, 


but get one with 


positive and negative 
- rails on each side. 


Wire stripper 


If you decide to get a spool of wire 
rather than a load of pre-cut 
pieces, you'll need a good 

way of getting wire off 

the spool. Attacking 

slowly and carefully with 

a pair of scissors or a knife 

gets extremely boring fast, 

and investing in a decent pair of 
wire cutters that will also strip the 
plastic will improve your life by at 
least 10% (don't quote us on that). 
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he (gets diminutive stature allows us s to make z an entire 
— gaming console out ofa simple USB controller for the 
first time. Here’ S how.. ae = 


This USB SNES controller 
knock-off might look sleek and 
slender, but it actually contains 
a cavernous wasteland ripe for 
the hacking... 


The PowerBoost 500 is the star of the show. It safely up- 
volts the battery to output 5V so you can power the Pi 
Zero, even when it's charging the battery via micro USB 


» USB SNES 
controller —- eBay 


4 a = war i 

5 3 me ere : « yf 

as oy sf 

= sg the ‘a 

Hl an + 

=n 117 1 ty ae 4 
omy! ia - 


» PowerBoost 500 
makersify.com 


a 
4 


~ atl 
= ——— i 
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= wore | 
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> 3.7V 500mAh LiPo 
battery - eBay 


> RetroPie 
magpi.cc/ 
Retro-Pie 


>» Mini HDMI-to- 
HDMI cable (3m) 
amazon.com 


With 3-4 hours of battery life, 
this tiny 3.7V LiPo is perfect 
for this project 


> 2x micro USB 
cables 
amazon.com 


fo 
a Ge 


We're going to carefully hack away 
at two of these micro USB-to-USB 
cables to steal the connectors. 
One will power the Pi Zero; the 
other will connect directly to the 
controller's USB cable 


his project was. " coming out of them isthis case’ | e : on n the inside, using just four tiny” 
inspired bya similar ae HDMI and USB ie power), SO. 7 USB colour- coded cables connected ~ 
; one undertaken by the i our new target -was to create a to a. slender circuit board that deals 
magazine’s features editor; Rob ~~ +completely self- contained console — with the inputs (D-pad and six 
Zwetsloot, a couple of issues back. -ina controller, with only one cable © buttons). How do we take inputs 
Rob took a modern USB version of | coming out to connect to the HDMI from the controller and get them 


Since they're 


cheats a retro Nintendo Entertainment port on a TV or monitor. Thus the to ‘the Pi Zero? It esau couldn’t 
actually pickets System controller, openeditup Pi Zero- powered SNES. Consoller _ be easier — all we’re going to do is i 
4 couple Setige and put the Pi Zero inside. While was born... - eS Saks Bice _ -. snip off the controller’s USB cable | 
SNES controllers it worked perfectly, running = There’ Sa Shange large. ans - - and solder the wires directly to 
Fenietan, classic NES titles via RetroPie,we amount of technology to ee - a micro USB connector that will 
thought that the project could be inside the controller forthis. ~~~; slot straight into the USB port of 
taken one step further. Classic project to work. Fortunately, most ¥ the Pi Zero. Since USB cabling is 


controllers don’t have two cables USB controllers are largely empty = g ee eee it just works. 
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: é = _ == L oye) =a = 


4 "Carving: the case. 


= Before we do anything else, 


~ though, we need to create some - 


ee : “more space in the controller itself oS 
2 We'll work on the back plate to. 
eres: _ Snip 0 off the support: struts first; 


e your: mileage may vary depending 


; 7 OD which USB controller’ you buy- 
Sines ‘(there are hundreds), ‘but ours has.- 
-- three supports on each side of the: as 
ek - “controller. Snip them with some cae 
ao side cutters Or chop them: with a ae 
eal ~ craft. knife, and then sand down’ 
Ne “any sharp edges so ey. re flush: = 
cae oil | Seco carefully strip back the housing of 


to the case. 


<i We’ Il also likely ee to remove : 
es a 1 couple of the Screw hole supports = 
; on the controller itself, but don’t. ~ 
a get ¢ carried away yet = you should - 


: play it by ear as. we try to fit 


P everything inside, SO We remove as 
_ in the case is decided by the 


: few of-the screw holes as possible. 
2 = Once complete, we ate need : 
Se to snip off the four USB wires = 

| connected to the controller’s 


- control board, leaving enough play ~ 


ee : = =a =a 


4 
nll 
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‘in the Ske to 9 ultimately c connect - 
= » the other end to your Pi Zero. To. = = 
oa keep things really simple, we’ re | 
os ‘going to connect a. Slimline 1 mini~ cas 
~ HDMI-to-HDMI cable to the Zero. 
“inside the controller. With our: : 


controller; it? 5 actually really easy - 


_ just to. line ‘up. the HDMI cable with 
the USB cable exit on the controller 
“itself, ‘but you'll need to use a craft. 


knife to carve a larger opening and- 


the mini HDMI connector to get it 
to fit snugly. 


| “Securing your Pi Zero. 


- The next thing to do is to secure = 


the Pi Zero .in place. Its location 


HDMI cable. We want to fix 

‘it directly to the controller’s 
control circuit board. There’s a __ 
good chance there’s a couple of 


r nh - 1 ye a 5 ic " 33 . 5 | 
090000000900008 aE P 


9900000000007 


: raised components on the back, 


: ~~ Command Strips. This gives us 
the clearance we need to steer 


“as the flexibility to remove or vary 


STs ed in place, we can also work 
on the placement of the battery 


so the micro USB power connector 
- on it sits against the bottom-right 
~ straight edge at the base of the 
controller. This allows us to add 


“jumper cables — for power (red), 


P! ZERO CONSOLLER 


SO we’re using sticky Velcro 


clear of the components, as well 


Make sure you 


_ the Zero’s placement during the 
~ build process. Once it’s securely 


have avery sharp 
craft knife, a 
decent soldering 


= iron, and a set of 
and the PowerBoost 500, safe in 


small screwdrivers 
the knowledge everything fits to hand — you 
together as it should. We plan to won't get far 
position the PowerBoost board just without them. 


under the right side of the Pi Zero, 


a power switch in the bottom- 
centre of the controller and place 
the battery in the right-hand 
compartment, which is currently 
completely vacant. 

Since the PowerBoost 500 ~ 
automatically powers on when 
you connect a battery to it, we 
need to fit a power switch to 
turn our SNES Consoller on and 
off. We’re using a very standard 
three-pin switch that we got from 
a basic electronics kit, and three 
colour-coded male-to-female 


eround (brown), and control 
(orange) — with snipped-off male 
ends so they can be soldered to 

the PowerBoost board later. Next, 
tape the female ends of the jumper 
cables together and then simply 
Slot the switch into it. We position 
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SOLDERING 
THE POWERBOOST 500 


Using the PowerBoost 500 to power your project is 
ridiculously easy and convenient, but we do heartily ats 
recommend you refer to Adafruit's excellent guide at 
magpi.cc/1PmIDWL. You'll learn about allits features 
and capabilities, and also find out how to solder the- A 
board correctly. As you can see from the image, we ; 
need to solder the three highlighted pins for our power 
switch to work correctly. Once complete and with the — 
battery connected, you'll find that when you flick the 


switch from nearest the ground pin (brown) to the power 


pin (red), the unit will power up and down. You'll also 


find a handy micro USB port on the PowerBoost board — 


position this against an outside edge of your Consoller, 


charge your battery - even while you re playing = 
% 7 Sr Sara PBS : 


Fe) OVUC 92 


ee iin trickiest part of the project. 

2 Usually, the power cables on these - 
‘LiPo batteries are quite short, so 

of you might have fun getting it to fit 

: correctly. Also, since we want to 

- utilise the charging capabilities of. 


ah Lik: ' 


the switch in the middle-bottom 
of the board (under the Pi Zero 
and next to where the PowerBoost 


' 500 will go), carve out space for ~~ 
( the switch to fit flush, and vot its 


“At this point, it S wise to ensure 
“you can actually still close the | 
case e and ind see sticking gpoints: 


down to the controller’s control 


board to keep it in place. Refer to 
the boxout on the left to see how __ 
® tosolder it correctly. <e 
carve a port out of the plastic, and you ‘ll be able to Oe = oe oe et 

oe fe Positioning the. Pye oe 
es | -PowerBoost and battery. 

}- es ee With the switch and PowerBoost 

He - prepared, we can work on 
a & the | positioning of both the» 
1 eo PowerBoost and the 3. TN 500mAh é 
= S the PowerBoost to the controller’ Se S ee 
oes circuit board so it actually sits 


xe the PowerBoost board, the micro - 


- 


—e — we 


USB port needs to be facing a clean 
edge of the controller so you can 
carve a suitable hole for it. 

We-ve positioned the 
oe as to our x 


s ; reset Buch with the AR USB 
: “facing the bottom edge of the | 


board. Helpfully,. this means the: 
battery connector is already cing 
the correct direction to allow the. 
battery to take up the rest of the: 
compartment on the right. Since 


ves Patt of. the PowerBoost’ sits Ore: 


| the right edge of the Pi: Zero when 
it’s in the case, we’re using two. 


_ double- sided sticky tabs to. connect” 2 


“lower than the Zero. The artery | 


“At this point, it’s wise 2 to ensure 


- you can actually still close the case 
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wa — | eee aE —=— — —_—* — - = = 1 aS 


ih 
rr 


> itself doesn’ t need fixing i inplace, 
- since its size means it doesn’ A Sie 7 
| move around: | ae 


SF ten 
mets 


eh find: any y sticking points (hate 
“need adjustment. We found that 
we had to remove some of the © 

- : “support struts for the Screws, but 
“we made.sure at least two (the far~ 
“left and right ones) were: left intact” 


st “so we could still securely fasten” oe = 
: a - the case. Me SS 5 ae 


_ soldering the micro  USBS 
In terms of practical hands- ‘on. 
work: left: to do, we’ re nearly there. 
_ The final taski is to physically — 

~ connect the Pi Zero tothe USB: 

~ cables and the PowerBoost. With 
- the power, it’s. perfectly fine to 

- solder.the 5V and ground pins 

aoe from the PowerBoost: directly _ 
to the 5V and ground pins-on. S 
your Pi Zero’s GPIO, but.since 

~ you’ll likely to-.want to use your 

~ Pi Zero for something else in - 


raspberrypi.org/magpi 


3 oe ae ,we’’ | 
take the lessi invasive toute oe co S 
oe “tipping up. a. ‘separate micro USE 


= - PowerBoost instead.” SF 
The great thing about USBi is that. : 
~ the four colour-coded cables are 
a Same, regardless of USB size: 

- two for power and two for control. 


es decided to. 


~ cable and: soldering t that to the: 


To SO merane Pi a we only need 
the red and black cables: power 


and ground, respectively. These 
go to the two outer connectors on 


: your micro USB cable — with the ~ 


longest flat edge of the connector 


facing up and towards you, ground 
is on the left. Just search for ‘micro 
- USB cable connectors’ for a handy 


diagram to refer to. Simply solder 


_the ground and power cables to 
~ the 5V and ground pins on your 


PowerBoost ~ it’s really that easy. 
Connect it to your Zero for 


att testing - assuming you havea ~ 
‘correctly configured SD card in 


your Pi Zero, it should light up as 
normal when the power switch is 
turned on. 

Connecting the controller 
micro USB is just as easy. With 
the longest edge of the micro USB 


= ote facing up and towards you, 
= the colour-coded USB cables you 


__ snipped off earlier are soldered 
from left to right as black, green, 
_ white, and then red. With the 
“micro USB connector soldered, all 
you need to do now is preconfigure 
your Pi Zero with RetroPie and 
ton Ae go! ; 


“the great Hane about USB is s that 
the four colour- coded cables are. 
the same, regardless of USB size 


: Setting up RetroPie | 


That’s it — you’ve done the hard 
part! Now all you’ve got to do 

is follow the instructions at 
magpi.cc/Retro-Pie to set it up on 
the microSD card to slot into your 
Pi Zero. It already has a version 


that supports Pi Zero. Since there’s 2 
no room for WiFi in your Consoller, 


we heartily recommend you set it 
up using a USB hub with keyboard 
and mouse, making sure you 

load all the games you want and 


‘scraping the internet for synopses 
~and images in advance. We can’t 


help you acquire games for obvious 
reasons, but search engines are 
most certainly your friend. Once 
complete, simply load it in your 
project Pi Zero, close up the case 
and power up for some serious 
retro gaming action! 


We love RetroPie. 
It's the Kodi or 
openELEC (home 


theatre front-end) 
of the retro gaming 
world. Grab it from 


magpi.cc/Retro-Pie 


You'll need to 


carefully check 

the dimensions of 
your case against 
the dimensions of 
your chosen battery 
to make sure it 

fits correctly. It'll 

be snug, but it’s 


easily done. 
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An easy first soldering project, adding a reset switch t to your 
(WPAN -— or full-size Pi is a great way! to prevent: crashes _ 


and hangs from. Base ver ae 


You'll 
Need 


» Soldering iron & 
solder 


> 2x 2.54mm male 
header pins 


>» Recycled PC 
case reset switch 


Or 


>» Momentary 
switch, 
normally open 
magpi. 
cc/2daXrPZ9 


> 2x female 
jumper wires 


A reset switch salvaged from 
an old PC case is perfect for 
this project, coming with its 
wires already attached 


~ he Pi Zero’s diminutive 
/ size, low cost, and tiny 
power requirements 
mean it’s a great fit for embedded 
projects. There’s onlyone= 
problem: how to quickly get things 
back up and running if your code 
hits an infinite loop or otherwise 
crashes the Pi Zero, especially 

in projects where the Pi Zero is" 
locked away from prying hands 2 


and powered by a hard to interrupt - 


internal battery. 
The solution? A reset switch, 
wired to the RUN header on the Pi 
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Zero, hich can restart the Pi i in 
the event ofa crash, or power iton 


froma shut down s state. 


> STEP- “Of 


Find the RUN:Header’ — 


Known as header P6 on early. _ 
models, the RUN header 1s linked 


_ toa pinin the processor which 


keeps it in standard running mode 
— hence the name RUN. When _ 
pulled to-ground by shorting one 


contact on the header to the other, “ss 
- ; The RUN header is unpopulated in 


the processor leaves the RUN 


state. To all intents and purposes, © = 


video header (marked ‘TV’). 


" >STEP-02 


Sie Gn 
Wa 


Oh A! 
oN N 


Available on any modern 
Raspberry Pi, the RUN header 
can be used to recover from a 
crash or launch a shut-down Pi. 


this has the same effect as briefly | 


: cutting the power to the processor; 
_ if the Pi was running, it will reboot, 
~ andif the Pi was shut down, it will 

: power on. 


. The RUN header can be found on 


: the Pi Zero at the right-hand side 


of the board, sandwiched between 
the GPIO héader and the composite 


Insert the male headers 
all Raspberry Pi models, meaning 
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With male headers in RUN header in step 2. Press the 
place, wiring up the . : = 
switch is as simple as iron against the base of one pin, 
pee de erase making sure it’s also touching the 
NGRePES shiny copper ring or square on 

the circuit board. Count to three 
then, with your other hand, push 
some solder against the base of 
the pin without touching the 
iron’s tip. 

The solder should melt then 
appear to be ‘sucked’ into the 
header’s hole. If it doesn’t, 
remove both solder and iron, 
clean the iron’s tip, adjust your 
positioning, and try again. 


>STEP-05 
Inspect the joint 
With both pins soldered, inspect 


ae Se doesn” t Bave: any pins inserted. 

m While i it’s possible to solder aon ete your handiwork before trying to 
Ses Eade ‘switch: directly to the header, eet use the Pi Zero. The solder joints 
eres doing SO: will block the GPIO, ara we “camp? buts not eisdien: S: you’re should appear to flow smoothly 


fears headers; it S better to solder male using. brass shavings, no water up from the circuit board to the 
| pins into the. header and: run Wites ° Seated. Scr pin, without any gaps. If you can 
| to ‘the reset: switch. aire = ny - ‘Give the i iron a. few. minutes to still see copper on the circuit 
e Take two. of the pins ina ‘bundle ae = heat Up, then. wipe the tip onthe — board or the solder isn’t sticking 
| . and snap them off by placing your : sponge Or brass shavings. When — to the leg of the pin, apply the 
te thumbnail into the divotinthe =. — nee ‘tin’ the iron by melting —_—iron again to ‘reflow’ the solder 
fers plastic between pins and Tighe a small amount of solder onto : ~ and, if required, add more. 
- Insert these into.the Pi Zero’s RUN =< the tip, then wiping itonyour Make sure you haven’t 
ok header from the top,andsecure ‘cleaning material again. The tip. . connected the two pins together 
them with tape or Blu-Tack, Fea - should look shiny, with no sign of with excess solder. If you have, 
ay for soldering. : = ee aes black residue Or discolouration. ~ use a desoldering pump or braid 


=F Digs a ony le op . to remove the excess, otherwise 
: >STEP- 03. eo >STEP-04. =o the Pi will fail to boot. 

ey Prepare the i iron Solder the pins ex Tene 
Make sure your iron is safely -- Turn the Pi Zero over to expose >STEP-06 
" in its stand, then plug it intoa the pins you stuck through the Wire the switch 
ede | : | x | : If you’re using a reset switch 
from a PC case, the female header 
can be inserted directly onto the 
RUN header’s new pins in either 
orientation. Otherwise, use a 
pair of female-to-female jumper 
wires to connect the pins to any 
switch described as ‘momentary, 
normally open’. These can take 
many forms, from cheap tactile 
switches to more expensive 
vandal-proof devices. 

Briefly press the switch to reset 
when the Pi is running, but be 
warned this can cause SD card 
corruption if the Pi was writing 
to it at the time. If the Pi has 
been shut down, press the switch 


A dirty iron tip will make for difficult Just like cutting the power, using 


soldering. Clean-the tip regularly while the reset switch can cause SD card 
soldering, and re-tin with fresh solder corruption. Use it only when shutting 
every so often. _ tS aes ee the Pi down another way is impossible! 


A-small piece of Blu-Tack or masking tape can help Any coacannine normally open switch will to power it back on -— this is 
keep a component.in position while you flip the work fine for this project, including this high-quality 
board for soldering metal anti-vandal switch always safe. 
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Track Slack 
chat activity — 
with this LED 
display. You'll 
know ata glance 
if there’s quiet, — 
light chatter, or 
raucous debate 


- 9 communicate within- 
/ the Raspberry Pi - | 
ile Foundation we use 
Slack, the IRC-like chat service. 
There can be a lot of activity, and 
it's taken time for people to get 
their notification settings just 
right. But we wanted more than 
what Slack’s notifications can 
provide. We wanted to be able to 
see at a glance how much chatter 
was going on among colleagues. 
Luckily, Slack’s API and Python 
libraries are powerful and easy 
to work with. Assembly is easy _ 
and the materials inexpensive, 
especially if you use a Pi Zero. 


Initial configuration 
To set up your own Slacktivity = 
Monitor, start from a fresh install 


of Raspbian. For the Raspberry Pi - 


Zero, you need to use Raspbian 
Jessie, which can be found on 
NOOBS or be written to the SD 
card using the image found on 
the Raspberry Pi download page 
(raspberrypi.org/downloads). 
Like with other Raspberry Pi Zero 
projects, it’s probably easiest 
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Use the type of header 


desired configuration 


Boo 


to get everything configured | 
‘and installed with a Raspberry ~ 
Pi 2 or B+.and then move the 


microSD card to the Pi Zero when. ; : 
you’re ready. Make sure to do the »~ 


necessary updates by going into == “| » Pi Traffic Light 


the terminal and using: 


_sudo apt-get update 
- sudo: apt-get upgrade 


You’ll need to set some basic 
configuration options. From | 
the desktop, go to Raspberry Pi 
Configuration in the Preferences 
menu. Under the System tab, 
set your Pi to boot to the CLI 
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pins that work best for your 


®®9D9Q00000000000 


The Pi Traffic 
Light from 
Low Voltage 
Labs makes 
connecting 
the three 
LEDs easy 


® ’ - +, 
seas! ot ; 
SOS ww 


Command 
Strips area 
great way to 
temporarily 
mount projects 
exactly where 
you want them 


magpi.cc/ 
aVamjoL 


> WiFi adaptor 


> Right-angle 
header pins 


» Soldering iron 
and solder 


> Blu-Tack or 
Command Strips ~ «> 


= The Slacktivity. Monitoris smalLand light enough. ., 
:*. to be mounted to'a display. with Blu-Tack or 
“= Command Strips, rs 
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(command line interface) and 
enable ‘Wait for network’. You 
can also set these options with the 
command line utility raspi-config. 
Make sure you’ve also configured 
your Pi to connect to your WiFi. © | 
network. Alternatively, you can 


use a USB Ethernet aePo: with te 


your Pi Zero. 


_ From the command line, download ae 


: ae Python: Slack Client library: 


Sudo: pip ‘install 


3 ~~ slackclient - 


Downlo ad the ecto peer 


ae git: Tene: https: We ae 
enue. com/mrichardson23/ _ 


- Slacktivity- monitor. git” 


ee “You? i need. to use your own Slack 


: API token in the project code SO: 


s zs ag that. the Slacktivity Monitor can 
vee te authenticate itself. While logged 
| into. Slack, go to magpi. cc/1Val8OF - 

ers : and. click Create Token for the = 


3 user and team that you want. to. 
-monitor. Copy. that token code 
into your code, replacing the.text. 

= SLACK TOKEN HERE. 
~The code keeps. track of auehiy: 


the last minute of activity. If there - 
_ have been no messages sent within 


that time period, then the red LED 
will illuminate. If there have been. 
any messages (but less.than 15) 
within the last minute, then the 
~ yellow LED will illuminate: If 15._ 
or more messages have been sent 
within the last minute, the LED 
will turn green. You may need to - 
adjust this threshold to match the 
typical levels of activity in yOu 
Slack team. : 

Set up the script to run at BoE 
From the command line, execute: - 


sudo nano /etc/rc.local. 


Before the exit @line, adda 
line to boot your code: 


python /home/pi/ 
slacktivity-monitor/main. 


py & 
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“When you’re oe: save the file - 

it Z and shut down the Pi so that you. 

-* can solder the headers, add the Pi = S 
: Traffic Lights and, attach it where _ 

you need I it. pS pets 


o Se! 
BS Ten 


Solder header pins onto ‘the Pi Pere 


and connect the Pi Traffic Light: to 


- those pins. The code uses pin 15. 
for red, 14 for yellow, and 28 for 


ereen. This is because they’re all 


~ next to each other along with a. 


eround pin, so the Pi Traffic Light 


will plug right into the header pins 

“ and work like a charm. Depending 
‘on how you want to arrange your 
Slacktivity Monitor, you may 


want to change the pin numbers | 
and colours. 


Use Blu-Tack or Command Strips | 
‘to attach the Slacktivity Monitor to 


your display. 

When you power up the Pi, the 
script should start automatically 
and connect to your team’s 


instance of Slack. Even if there’s 


no recent activity, you may see the 
traffic light turn yellow initially 
because the Slack API will return 
the most recent message when a 


| new client connects. 


- The code ignores everything 


except messages, so you could also 
adjust the Slacktivity Monitor to 
react to different types of events. 
For instance, you can use the red 
light to indicate when your boss 

is offline, yellow when she’s idle, 
and green when she’s active. 


SLACKTIVITY MONITOR 


Main.py 


time 
Slackclient 
SlackClient 
gpiozero 


>PYTHON 
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2dXrLcb 


token # found at 
# https://api.slack.com/web#authentication 


red = LED(15) 
yellow = LED(14) 
green = LED(18) 


red. of f() 
yellow.ofFf() 
green.off() 


sc = SlackClient (token) 
message counts =[ ] 
sc.rtm_connect(): 


message count 
events = sc.rtm_read() 
event events: 
event[ | 
message count = message count 
message counts. insert( 
» Message count) 


len(message_ counts) 
message _counts.pop( 
total_message count 


al range( 
, Len(message_counts)): 
total message count 
total_message count + message counts[i] 


total_message count 
red.on() 
yellow.off() 
green.off() 


total_message count 
total_message count 
red.off() 
yellow.on() 
green.off() 


total_message count 
red.off() 
yellow.off() 


green.on() 


time.sleep(.1) 
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The Pi Zero comfortably fits 
into the handle, so even that 
can look the part 


» Adafruit bicolour 


8x8 LED matrix 
magpi.cc/ 
1ZMEBM4 


» Abig button 
magpi.cc/ 
1ZMEGPM 


» Battery-powered 
3v LED 
Christmas lights 


» Adafruit 
ADXL345 
triple-axis 
accelerometer 
magpi.cc/ 
a1ZMEMHh 


>» Aswimming 
noodle/woggle 


>» Apower bank 


» Soldering kit, 
jumper wires, 
and stripboard 


>» Some glue, a 
craft knife, duct 
tape, and some 
Velcro strips 


The pool noodle makes this 
a much safer and sturdier 
weapon than some of the toys 


As well as a light-up blade, 
you can have a custom display 
above your ignition button 


The Force i is strong: with the Pi Zero, so > how about using . | 


one e to power your ¢ own Pi-Saber: 


ecreating your faveunie 
/ Jedi battles is lots’. 
he of fun, but many - 

toy lightsabers can be quite. 
delicate. This Pi-Saber should’ 
be tough enough to survive . 
some energetic re-enactments. 
The LEDs that produce the 
powered-up effect will also’ 
fluctuate their brightness as’ 


the Pi-Saber-is swooshed around, ~ 


to maximise the excitement. 


We’re assuming you have 7 eee 


GPIO header attached. However, - 


for amore robust Pi-Saber, you 


could solder each connection 
directly onto the Pi Zero. 


Padawan's first steps 
First, prepare Raspbian on Pi Zero 
SO we can use Python properly:. 
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= Sado apts get instath git. 
~ python- pip python- -dev Brenan 


imaging python- smbus 


oe ee Anstalt spsorelO 


“Now install and test the 
accelerometer: We’re assuming. 


you have an ADXL345, but there are os 
i _ plenty of alternatives that will work : 


with some modifications. : 
First, install the handy 


sf ee bate 


git clone. https: //eithub. -com/ 
pimoroni/adx1345-python. git 

sudo cp adx1345 -python/ 
adx1345. py TUSHELOC ADE = 
python? 7/dist- packases/2 


The cel OMeIa uses the PC 
bus, so you’ll need to activate 


that by going into the Raspberry. - 
Pi Config program and selecting _ 
- the ‘Enable 12C’ option from the: 
-advanced options. After a reboot, 
connect the accelerometer tothe Pi 
_as shown in Fig 1. Change into the 
adx345 mates and run: ) 


“python example. Py 


f Wiggle t the accelerometer around 


: and verify that the displayed values. 


for X,Y and z change accounly. 


“tights for-an apprentice 
-_ The Pi-Saber will have a funky ; 
~ display on the handle that also turns 


= = on when you press the main button. 


_» There are plenty of neat Adafruit 
8x8 LED matrix units that come 


© with their own backpack to make © 
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Python control simple. For testing, 
you can simply connect them via 

a breadboard, but for the finished 
product you’ll need a more robust 
method. A simple option is to use a 
small piece of stripboard and either sg 
solder the wires directly or make 


use of a male header. As usual, there. 


is a great Python Mee ee the | ieee 
LED matrix: 


git clone https: //github. 
com/adafruit/Adafruit, _Pythons 
LED sateen Gane ay 


Then fnec into that directory - 
-and run the installer: : 


sudo ce asin 


There are several example ee 


esr scripts in the repo that von can use 
> for testing: Sr 


“= The étherL LED components: fat 
| the Pi-Saber are the ones that will 


~= cover the main shaft. There are 


~ plenty of options, but Christmas” 
lights are a great and cheap way 


ee of getting a string of pre- wired, 
= low- power LEDs. Obviously, the = 


-more LEDs you get, the more 
- dramatic the Pi-Saber effect... 
However, installing each one into 
the noodle can be quite tedious and 
time-consuming, so a string of 


20 isa good compromise between. 


aesthetics and sanity preservation. 
Snip the wires just before the. 
battery holder, strip back the 


- insulation, and add a female jumper | 


- housing to the end ofeachone.. 
Connect them up to the 3V and GND 
pins on the GPIO and check that 
they light up. Then switch one wire 
from the 3V pin to GPIO pin 17. 


Jedi Master saber 
The final element of the Pi-Saber 
is a nice big on/off button. Make 
up some wires with suitable _ 
connections, or simply solder 
directly onto the button’s contacts. 
Then connect it up to the Pi Zero’s 
GPIO pins (26 and one of the GNDs), 
as shown in Fig 1. 

Now it’s time to put everything 
together. Check everything is wired 
up as shown in Fig 1 and then power 
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PI-SABER 


PP JeOe\s C8 eC eee eR eeRe 
¢ gina:  ereesesoosscooses 


up the Pi. Download the PySaber.py : 
code (magpi. cc/AZMEVi3), or type it~ 
| into a text editor, and run it. 


~~... sudo python PiSaber. py 


Nothing should heen until you 


: press the button: the LED matrix 
‘should show a quick pattern and 


Nothing should happen until you press 
the button: the LED matrix should show a 
quick pattern and then start sparkling 


then start ‘sparkling’. Meanwhile, 
the LEDs on the string should all 
light up. Pick up the accelerometer, 
jiggle it around, and you should see 
the brightness of the LEDs fluctuate 
along the shaft. 

Once everything is working, 
add the line: 


python /home/pi/PiSaber. 


py & 


...to the /etc/rc.local file (above 
the ‘exit 0’ line) so that the code 
will run whenever the Pi is booted. 

Now chop the noodle in two and 
then slice one half open lengthways 
like a hotdog bun - don’t cut all 


the way through. Measure your 


noodle and make a sketch to work 
out how your particular power 
bank and button will fit inside. 
Once you've got this figured out, 
completely remove that much of 
one half of the noodle, leaving a 
wedge. Then mark out where the 
components go and cut away those 


chunks of the noodle. While you’re 
at it, cut out a small trench all the 
way along the rest of the inner 
noodle for the LED cable. 

Now calculate how far apart the 
LEDs should be to give an even 
Spacing all the way round, and 
then poke them through; make 
some pilot holes first with a meat 
skewer or something similar. Once 
everything is in place and the 
wires are tidy, glue the slit shaft 
back together all the way along 
the length. Cover the handle parts 
with duct tape and then strap them 
together with some Velcro. 

That should be it - now you’re all 
set for some epic battles. 


Fig 1 How to 
wire up your 
Pi-Saber without 
the noodle 


DOWNLOAD: 
magpi.cc/ 
1ZMFVi3 
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>» Gaming mouse 
- eBay 


>» Mini HDMI cable 
amazon.com 


> 2x micro USB-to- 
USB cables 
amazon.com 


> Quake III files 
(that you own 
legitimately) 


MORE #PIZERO PROJECTS! 


Wouldn’ tit be oreat if you could puta an entire computer 
intoa gaming mouse: Yes. Yes, it would... 


We've used an old Razer mouse 
from eBay for our project. You'll 
need to gut some of the plastic 
housing to make room for your Zero 


We picked a really slim mini 
HDMI-to-HDMI cable so we 
could fit it in the mouse. 
You'll likely need to remove 
the connector housing too 


--announced internally, » 
tle Raspberry Pi’s Eben — 
Upton came up with the idea of 
putting one in a gaming-mouse 
and installing Quake IJI.on it. Our | 
heads exploded. Since modern 
gaming mice have so many 
buttons, it’s actually pretty trivial 
to tweak the control settings so 
that running and jumping can 

be controlled without the need’ 
for a keyboard at all. In essence, 
a lot of what we’re doing with 
this project is an extension of the 
SNES Consoller project elsewhere 
in this feature: gut a gaming . 


™~S 
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hen the Pi-Zero was first. 


| mouse (most of it is just empty, | 


ergonomically shaped plastic - 
anyway), connect its USB to the 
Zero internally, and ' yan re e pretty : 


~ much done and dusted. 


~ Of course, these ahiias are 
invariably easier said than done, 


-and it did take:a few shopping - 


trips on eBay to finda suitable . 
mouse contender. We settled 

on an old Razer Lachesis from 
around 2009. Ithas a scroll wheel, 
two buttons directly behind said 


wheel, and two buttons on each 


side of the mouse. It.also has 


enough dead space inside'to fit our ; 
Pi Zero and HDMI cable. Perfect... = © 


This is the mouse USB 
cable. We've snipped it off 
and soldered a micro USB 
connector on the end, which 
fits directly into the Pi Zero 


Since there’s.a lot more going 
- on inside a gaming mouse than 


a retro.controller, we had to-do 

. away-with our plan to battery- 
‘power the Quake II mouse quite . - 
early on. The end result means 


that along with the HDMI cable 
~ coming out of the front in place of 


the original USB connector, we’ve 
als6 gota Slimline (but ultra- 


~ long) micro USB-to-USB cable. 
_Said cables are easily sleeved or 
.-. tape-wrapped together, though, . 
and most TVs these days offer USB. 
“.. ports that supply enough power to 
“run the Pi Zero. Ultimately, it’s a 


small compromise. 
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>STEP-01 


Gut the mouse 


__ It sounds gruesome, but it’s 


actually easier than you think 
once you can actually get into the | 
thing. Our Razer Lachesis hada 
solitary cross-head screw hidden. , | 
under a sticker on the bottom. Oks 


the mouse. With that rernoved, ee 


--we were able to remove the LED. 
light boards from the roof of. the 
_ mouse, and trim down some of — 
the support struts and plastic . = 
| motilding using side cutters. Razer 
had conveniently used connectors. 


“for the LED lights and even for." 


the USB port, soit was trivialto 


* -remove everything to create space: 2 it 


2 sSTEP-02” 


_ Soldering the micro- -USB- 
“-.:> Next, we snipped the USB cable-- 
efor the mouse, leaving enough play 
-- to-solder.a micro USB connector a 
ferker e on the.end that fits straight 
se into the Pi Zero. Tt just works.. 
eo, Sethe cabling i 1S staightioewant = ee - 


| “with the longest flat edge of the - 


ee ‘micto USB connector facing up 
- ; ‘and towards you, the cabling i ‘ape 
«1, soldered from left to right - ‘black, 
| green, white, and red. Since USB. 


is entirely universal, ‘there’ sno 

~ Way you'can get it wrong — just 

_ search for ‘ micro USB cable 
connector’ for example diagrams. 
It can be fiddly to solder, but with 
a decent i iron and some helping — 

| hands to hold it steady, it’s 

- pretty sttaightforward stuff. 
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>STEP-03 
Fitting the Zero and mini HDMI 
Now we want to fit the Pi Zero, 


_ taking into account that there’s 
_ going to be a(comparatively) — 


massive HDMI cable attached to it. 
- ee QUE best advice here is to buy the 
“slimmest mini HDMI- to-HDMI ~ 


“cable you can find, but you'll need — 


to use d craft knife to ee 
_Femove > the: chaning without. 


‘Zero sat Spe at an angle, with 


the HDMI cable snaking ‘around the : 


chassis to the front port where the 
old USB cable was. At this point, 
*s probably wise to ensure you: 


can. seal ae the mouse securely, See ee 
: sa plenty of play at the other end, and 
‘both the HDMI and USB cables can 
eS be plugged in. 


S = PETER OS 


Installing the software 


Pata ee 


jitter more 5 oF the alasti housing to 


accommodate its 


> STEP: oe ac 
_ Power your Pi Zero: 

Sadly, there’ S just not enough 
“room in the 1 mouse to house: 
a rechargeable battery and 


accompanying Sate, controller = 
board. Instead, we’re going to tuna - 
- slimline micro USB cable from the 


' Zero’s power port out of the front. 
‘of the mouse, alongside the HDMI 
“cable. Once ‘the project is complete 
and working, you can either tape- 
wrap the two cables together or get 
some decent heat-shrink sleeving 
to hold them securely together. 
You’ll need to ensure both cables 
are long enough so that there’s 


control to as many of the mouse 


The next step is to set up a 


~ Raspbian Jessie image on your SD 


card; we advise taking your Zero 
out of your mouse to do so, and 
using a USB hub with connected 
keyboard, mouse, and WiFi dongle. 
With Raspbian Jessie installed, 

you need to set up your game (in 


- this case, Quake III). Installation 


isn’t exactly a breeze, but.you 


can find full instructions on the 


process at magpi.cc/Quakelll. You 
need to recompile the game and 
acquire the pac files for Quake III 
from a reputable source. Sorry - 
our lawyers won’t let us be more 
specific than that! 


>STEP-06 

The ultimate gaming mouse 
With power and USB connectivity 
sorted, and an up-to-date install 
of Raspbian Jessie and Quake III set 
up, all that’s left to do is to pop 
into the options menu and reassign 


Raspberry Pi 


Beginners has a 
buttons as you can. We opted to really neat YouTube 
use the wheel to switch weapons, 
the left two buttons for forward 
and back, and the opposite two 
sides for strafing. It takes a while 
to get used to, but you soon get the 


hang of it. 


video showing you an 
alternative method 
of installing Quake III 
on your Raspberry Pi. 
youtu.be/ 
btSGRnXuAAA 
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The main indication that 
something is different about 
this controller, but it's a small 


price to pay. 


> USB NES 
controller (check 
eBay!) 


> A Raspberry 
Pi Zero - 
raspberrypi.org 


> RetroPie - 
magpi.cc 
/2iHVgNba 


> A rotary tool (like 
a Dremel) 


> An old micro USB 
cable 


> Ascrewdriver, 
soldering iron 
and a way to 
strip wires 


ROB ZWETSLOOT 


Tech writer, avid coder, and Raspberry 
Pi enthusiast with a history of building 
many things with Raspberry Pi. 
magpi.cc 


A standard knock-off USB 
NES controller works 
perfectly for what we 
have planned 


We make last month’s project idea into reality with a NES controller 
that’s been Zero-charged to be able to run NES games... 


ver Since first seeing the Raspberry Pi Zero a 

few months ago at Pi HQ, we’ve spent a lot of 

time since then thinking about the cool ways 
that the Pi Zero can be used. One of our first ideas was 
slipping a Pi Zero into a NES controller, taking a bit of 
inspiration from Ben Heck’s great inventions to further 
miniaturise the NES to its most core component. 

We wrote about how you could do this last issue but 
we have now finally had time to make a proof-of- 
concept, So we’re going to show you how to exactly 
put a Pi Zero inside an NES controller. 
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Set up RetroPie 
This is really more for convenience than anything 
else. Download the RetroPie image and write it toa 
microSD card using your preferred method (check 
the Raspberry Pi guide if you’ve not done this before: 
mMmagpi.cc/1XTmymk). Once it’s written, open it up in 
your file explorer and navigate to home, pi, RetroPie 
and put your NES ROMs into the nes folder. 

Pop the micro SD card into the Pi Zero and hook the 
USB NES controller up to it before turning it on. You can 
then do the initial setup and configure the controller. 


Make some space 

It seems that many USB NES controllers have roughly 
the same internal structure (they may be using a mould 
of the NES controllers, or just a generic one) and it is 
therefore likely that you’1l need to make some space. 

We used a rotary tool to trim the screw holes and a ring 
on the edge. We wanted to use the original USB wire port 
for our HDMI cable, so we suggest that you lay the Pi 
Zero (with SD card inserted!) inside the back plate and 
figure out where needs to be trimmed. 


raspberrypi.org/magpi 


Tutorial 


> ite © ates 


We used a Sharpie to mark out the cuts we needed to make by 


periodically laying the Zero over the backplate as we worked 


Cable holes 
If you’re doing what we did, not only will you need to 


widen the USB hole to allow for plugging in a mini HDMI 


cable and a new hole for the power port to slot in, you’ ll 

also need a space for the micro USB port to jut out. 
Mark the amount of space you’1] need to cut out for 

the mini HDMI cable to fit in; you can even consider 

cutting a square out of the back plate to help it to 

slot in more easily. Test it as you go, but be careful 

of plastic shrapnel as you file it up. 


All that's left 1s to 
plug itintoa TV 
and power supply... 


Wire up the controller 
USB cables are wired up very simply, with four 
wires providing power, ground and data. Luckily, 
the colouring of the wires inside a cable is standard. 
Snip off the end of the micro USB cable you want to 
sacrifice and strip off the rubber, the braided wire 
and the foil surrounding the four individual wires. 
Strip them to reveal the core. Do the same with the 
USB cable on the NES board: on ours the wires were 
accessible before the cable insulated them. 

Solder the corresponding wires together and 
individually insulate them with electrical tape or heat 
shrink tubing. 
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gaa rad 


Assemble it 

We used a bit of Blu Tack to secure our Pi Zero to the 
inside of the base plate while carefully making sure 
the micro USB connector was plugged in and not 
obscuring any of the screws or clips connecting the 
controller together. We then carefully screwed it in 
and checked that the connectors fitted. All that’s left 
is to plug it into a TV and power supply and make sure 
the whole system works. 


Game on 

As we have noted, our version is simply a proof of 
concept. It did, however, survive a solid six hours 

of young kids getting very frustrated over old games 
at Pi Wars, so clearly the controller and Pi Zero are 
robust enough to handle extended play sessions. 
You will need to dismantle the device to get to the 
SD card and load or change ROMs on it. You could, 
however, probably get it to connect over WiFi and 
transfer files over SSH. 


Our cutting 
is a little rough in 
places; you may 
also need to open 
up the bottom of 
the controller to fit 
the cables in 


You just have to 
look at the Xbox 
controller hack 
from earlier in 


the magazine 
to see how 

this could be 
done with other 
controllers 
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INTRO 


Find out what the best add-ons, operating systems, and books are for 
your Raspberry Pi adventure 


PROSTER 


CR20G2 


\— fit BS 
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Digital 
Soldering 
Station 
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PIANO HAT 
A musical instrument 
attachment for your PI 


IQAUDIO PI DAC+ 
Get better audio output 
from the Raspberry Pi 


LIGHTBERRY PI 
Improve movie night 
with this ambient light 
kit 

SPI-BOX 

A special kit for 
creating a simple CCTV 
system 


SENSE HAT 

The special HAT that 
powers the Astro Pi 
mission 


PROSTER 
MULTIMETER 
Check the circuits in 
your project with this 
multi-function tool 


ADAFRUIT GEMMA 
Wearable tech is 

all the rage, make 
something of your own 


MEDIA PI PLUS 

A special enclosure for 
your Raspberry Pi that 
makes it the ultimate 
media centre 


PIMORONI DAC HAT 
Another HAT that 
promises to improve 
your Raspberry Pi 
audio 


PI-TOP 

The crowdfunded 
Pi laptop you build 
yourself 


\Ae 
] 
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ALS 
nt 


| 


DIGITAL SOLDERING 
STATION 

Improve your soldering 
technique with this 
advanced soldering 
Station 


BARE CONDUCTIVE 
TOUCH BOARD 
STARTER KIT 

Create fun electronics 
projects with conductive 
paint and more 


MAGZOR STARTER KIT 
Build custom robots 
with your own 
specifications 


CAMJAM EDUKIT 3 
A tiny robot kit in 
honour of the Pi Wars 
competition 


UBUNTU PI FLAVOUR 
MAKER 

Create your own spin 
of Ubuntu for the 
Raspberry Pi 


LCD CONTROL CASE 
A special case for your 
Raspberry Pi that lets 
you use a tiny touch 
screen 


RASPIROBOT V3 
Use this robot motor 
board in your next 
Raspberry Pi robot 


ZEBRA ZERO 

A lovely wooden case 
made especially fora 
Pi Zero 


BOOKS 

Get the low-down on 
many excellent books 
that can help you make 
and code 
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Maker 

says 

A Pi- 
based piano, 
transformed 
with 
Pimoroni's 
Signature 
polish 


Pimoroni 


MAKEY 
MAKEY 


This versatile 
board has been 
used to build 
a piano from 
stairs, a camera 
trigger using 
water, anda 
keyboard from 
pasta. ‘ge oh 
Ps al o ¢ 


£40 / $50 
makeymakey.com 
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PIANO HAT 


Les Pounder looks at a HAT-based piano keyboard 
which uses capacitive touch keys for input 


n 2014, a14-year-old 
called Zachary Igielman 
launched a successful 
crowdfunding campaign for his 
Pi Piano. Originally created using 
a MCP23017 GPIO expander and 
a series of momentary switches, 
the Pi Piano used a piezo buzzer 
to simulate the tone of a note. 
One of Zachary’s advisors was 
Phil Howard from Pimoroni, who 
worked with Zachary to create 
this new and improved version. 


Crowdfunded project 
The latest incarnation is now 
known as Piano HAT and uses a 
capacitive touch-based interface 
to simulate a portion of a 
traditional piano keyboard. The 
board measures 64mm by 56mm 
and fits neatly on top of the 
models A+, B+, and Pi 2. Beinga 
HAT board, it also attaches to all 
40 of the GPIO pins. As well as 
the keyboard, we have the ability 
to raise and lower the octaves 


and change instruments via three 
extra inputs on the board. 
Hardware is just one part of this 
project, and the software which 
supports Piano HAT is all based 
on Python, which enables existing 
projects created in this language 
to easily integrate Piano HAT. Phil 
Howard has written a series of 
examples which use the Pygame 
library to demonstrate how to use 
Piano HAT as a typical piano via a 
series of audio samples, which can 
be swapped for any types of sounds 
should you wish to build your own 
input. Piano HAT also comes witha 
tutorial which demonstrates using 
the built-in LEDs to teach playing a 
simple tune, in this case ‘Twinkle, 
twinkle, little star’. So, using 
this library, we can code our own 
tutorial for others to learn with. 


Powerful MIDI 
synthesiser 

Software is not just limited to 
simple samples. In fact, Phil has 


supplied a number of methods to 
connect the Piano HAT library to 
a MIDI service running on your 
Pi. This then turns the Piano HAT 
into a powerful synthesiser input 
for software such as Yoshimi and 
SunVox, although a Raspberry Pi 2 
is required for these applications. 
The Piano HAT looks like a 
rather simple board, but thanks 
to a clear Python library, well-built 
hardware, and a powerful MIDI 
control option, we have a board 
for musical adventures. 


fast word 


Such a simple board, but with 
limitless applications thanks 
to Python and MIDI. This isa 


great platform for musical 
experimentation and it can 
easily be used with Minecraft 
and other projects. 
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IQAUDIO PI-DAC+ 


Waker 
says 


Outstanding 
sonic performance 
with variable 
phono line out 
and dedicated 
headphone 


amplifier 
IQaudi0 


IQAUDIO PI-DAC+ 


palate Any Raspberry Pi becomes an audiophile music streamer 
qetated with this high-resolution DAC and headphone amplifier 


AUDIOPHONICS 
I-SABRE 
DAC ES9023 


The DAC from 
Audiophonics is 
a similar price 
to the Pi-DAC;:, 
but it lacks a 
headphone 
output. It uses 
the Sabre 
ES9023 DAC 
instead of 

the Texas 
Instruments/ 
Burr Brown DAC 
in the Pi-DAC+, 
and includes a 
pass-through 
GPIO connector 
so you can 
stack additional 
boards. 


£30 / $48 
magpi.cc/2dr8X2d 
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ven a standalone Pi makes 
a very decent music 
streamer, but add a high- 
quality DAC and it becomes a true 
audiophile device. The IQaudIO 
Pi-DAC plus is a HAT-compliant 
board which uses the IS interface 
for optimal transmission of digital 
audio between the Pi and the DAC. 
Once fitted, you get analogue output 
from either two phono sockets, 

for connection to an amplifier, or 
a 3.5mm headphone socket, along 
with additional pinouts for adding 
optional features. 


No soldering required 

The board comes without any 
instructions, but you can find 
these on the IQaudIO website. No 
soldering is required, and it works 
with Raspberry Pi A+, B+, and 2. You 
need to screw the supplied spacers 
to the Pi to support the board, then 
you simply connect it to the Pi’s 
GPIO board, screw it down gently, 
and that's that. 


IQaudlO can also supply a case, 
an acrylic affair that has suitable 
cut-outs for the Pi-DAC+ ports. 
Once assembled, you can 
download a number of audio-centric 
distributions that have Pi-DAC+ 
drivers built in — including Volumio, 
RuneAudi, and PiCorePlayer — or 
follow the directions to add support 
to an existing installation. There 
is also a preconfigured Raspbian 
image on the IQaudl0O site. We 
used Volumio 1.55, which worked 
perfectly. The music source can be 
anything from files ona NAS, toa 
streaming service such as Spotify, 
or a directly attached USB hard drive. 


Excellent sound 

The DAC sounds excellent, 
powered by a Texas Instruments 
PCM5122 DAC at resolutions up 

to 24-bit/192kHz. From a sonic 
point of view, a Pi equipped with 

a DAC like this can hold its own 
with far more exotic and expensive 
company. We were also impressed 


with the headphone output: 
tested with a pair of Sennheiser 
HDooo headphones, the sound 
was superb, with the clarity 
and spaciousness that you get 
from the best audio. 

Expansion options at extra cost 
include attaching a rotary volume 
control or an IR sensor for remote 
volume control. The Pi-AMP+ is 
2x20W stereo amplifier which 
attaches to the top of the board. You 
can also use the supplied optional 
right-angled header, designed to be 
soldered underneath the Pi-DAC+ 
to access the Pi’s GPIO signals. 


fast word 


Great sound and the inclusion 
of a headphone amplifier make 
the Pi-DAC+ a recommended 


accessory for music-loving 
Pi enthusiasts. 
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Easy 
to install, 
Simple to 
use, d joy 


to watch 
Lightberry 


HauptMenu Favoriten 


LIGHT BERRY 


Russell Barnes tests a technology designed to add a new dimension 
to your home cinema experience 


PHILIPS 
AMBILIGHT 


The real 
alternative 

to Lightberry 
is an actual 
Ambilight TV. 
The cheapest 
we could find 
(at the time of 
writing) was 
£350. Ouch. 


bit.ly/1uiGm9Y 


ightberry is inspired 

by a TV technology 

pioneered by Philips 
called Ambilight. While the tech 
naturally comes pre-fitted on 
Ambilight TVs, it’s perfectly 
possible to modify any TV to add 
its special kind of ambience- 
enhancing trickery. What does it 
do? The premise is simple: you 
affix a ring of colour-switching 
LED lights to the back of your 
LCD TV and - assuming your TV 
is against a wall and the ambient 
lighting is low - the colours on 
the LEDs are designed to perfectly 
sync with the action on screen 
in colour and intensity, so that 
light appears to bleed out of the 
Screen and dance against the wall 
in the background. 

As with Philips’ creation, 

Lightberry — which harnesses 
the power of the Raspberry Pi for 
computation — is all about adding 
a little more immersion into your 
viewing experience. While the idea 
is Simple, the technology behind 
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it certainly isn’t, though for most 
people the results really do speak 
for themselves. 

Sold either as a full kit starting 
from just over £50 / S80, or 
as constituent parts available 
separately, Lightberry is 
designed to take the pain out 
of the technical aspects, giving 
you as close to a plug-and-play 
experience as you could hope for. 
Obviously, sampling millions 
of pixels of onscreen data and 
converting that to the right LED, 
colour and brightness at exactly 
the right moment isn’t the 
simplest project to tackle, but 
Lightberry manages to make it 
easy. It’s also designed to work 
perfectly with the best software 
solutions for this technology, too, 
including Hyperion and Boblight. 

Once you’ve picked the right 
length LED strip to fit your 
particular size of TV and ordered all 
the kit you need, it all arrives boxed 
and ready to assemble. While we 
found no instructions in our box, 


magpi.cc/2drsyPG offers brief 


but functional step-by-step 


instructions to get you up and 
running. Probably the fiddliest 
part of the process is arranging 
and affixing the LEDs themselves. 
Elsewhere it simply requires 


you to connect the appropriate 


converter box, download software 
and install it onto an SD card-a 
process any Raspberry Pi user 
should already be intimately 
aware of. 


While it can take a little trial 
and error to best position 
the LEDs, once you've hit 
the sweet spot we found 
Lightberry a joy to use. It's 
not the cheapest Raspberry 


Pi project, but it's one that is 
sure to please the movie fans 
in your household. 


KKK 
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Maker 
says 
The 

security 

camera 
solution 
for the 


Raspberry Pi 


SB Components 


NATUREBYTES 


Although 
designed fora 
different use, 
the Naturebytes 
Wildlife Cam 

Kit could be 
configured for 
security. It's also 
weatherproof. 


£149.99 
magpi.cc/1QnR4k8 
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security device that won’t break the bank 


t’s one of those classic 
tutorials in tech mags 
with small PCs and 
microcontrollers: the motion- 
detecting camera. There are many 
ways you can do it — some easier 
than others — and the Raspberry Pi 


offers many tools to make a project 


like this quite simple in general. 
Enter SB Components with 
a dedicated motion-detecting 
camera kit for the Raspberry 
Pi. Designed as a cheap security 
system, the features that make up 
the kit are quite standard: a PIR 
motion detector, a specialised case 
for the whole setup, and even a 
custom version of Raspbian with 
software for sending security 
alerts. All for just over £10; throw 
in the cost of a Raspberry Pi B+ or 
2 with a Pi Camera and - on paper 
- you’ve got yourself a pretty good 
security camera for about £50. 
Assembly is dead simple. 


The case splits in two and the 
Raspberry Pi clips into the bottom 
part, with full access to all the 
major ports around the edges. The 
PIR and Pi Camera can be screwed 
to the lid, while a set of three 
wires is used to connect the PIR 
directly to the GPIO ports. Pop in 
the supplied SD card and you’ re all 
ready to get started. 

The case has pretty standard 
mounting holes on the back for 
fitting over a couple of screws 
attached to the wall. You’1l need 
to set up the emailing system on 
the device, accessed through the 
config files on the SD card, which 
you can probably do from another 
computer; however, all it then 
needs is a WiFi dongle and power 
to do its job. 

As the code is written in Python, 
it’s quite simple to modify if you 
need to tweak the sensitivity, 
or the way it captures photos or 
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A very simple solution to creating a motion-detecting 


video. It all works pretty well, 
especially for the price, although 
we wouldn’t rely on it for any 
serious security work. 

Really, this is as good as any 
other Raspberry Pi security camera. 
It'll be a lot better than one you 
try to put together yourself, and 
probably cheaper and neater too, 
So give it a look if you’ re interested 
in a bit of added security. 


fast word 


A great little kit that very 
simply creates a serviceable 
Pi-powered security camera 
that's great for any indoor 


application. It also barely 
breaks £20 (with camera), 
making it a cheap way to keep 
a better eye on something. 
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Waker 
days 


Make 
your own 


Astro Pi! 
Raspberry Pi 


ARDUBERRY 


While there's 
nothing quite 
like the Sense 
HAT, the 
Arduberry 
allows you to 
connect Arduino 
boards to the Pi, 
enabling you to 
create your own 
custom sensor 
suite, albeit at a 
greater cost. 
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$29.99/£19.70 
magpi.cc/2drt54j 


SENSE HAT 


£23/$35 


SENSE HAT” 


Space: the final frontier. These are the voyages of the Sense HAT. 
Its mission: to make sensing the environment really easy for 
Raspberry Pi users. To boldly go where no Pi has gone before... 


f you’ve been reading this 
magazine from cover to 
cover (which you really 
should, we have some top-quality 
content in here. Don’t worry, 

we’ ll wait here for you to catch up. 
Done? Good!), you’ ll have seen our 
release story for the Sense HAT 
that starts on page 6. This is the 
little board that makes the Astro Pi 
possible, hosting a suite of sensors 
along with a very simple LED 
display. The idea is that it sits on 
top of your Pi’s GPIO pins and gives 
you access to much more data from 
your surroundings through a few 
extra packages. 

Like all the other hardware 
produced by the Raspberry Pi 
Foundation, it is fairly cheap. On 
the other hand, it’1l set you back 
nearly as much as a Raspberry 
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Pi 2 Model B, so could be viewed 

as being a little expensive for an 
add-on board. In the grand scheme 
of things, though, the Sense HAT 
represents great value for money 
considering the functions it grants 
you. The reason it is so inexpensive 
is because it was designed to be 
easily constructed, with a few 
compromises made to keep the 
price down. 


Cheap as silicon chips 
Don’t get us wrong, though: 

the Sense HAT is definitely not 

a cheap product. It’s the same 
sort of sturdy construction as the 
Raspberry Pi, and doesn’t have 
any easily broken sticking out 
capacitors or other components. 
It’s built to be blasted into 

space, after all, so needs to be 


pretty robust. We wouldn’t start 
stamping on it to try to test out 
how tough it is, but it’1l survive 
being man-handled onto and off 

a Raspberry Pi. It fits very snugly 
on the GPIO pins (taking up all 
40), and can even be used with 
other GPIO headers or wires to 

the individual pins. There’s no 
programming issue with this, as 
long as you’re not trying to use 
the functions of the Sense HAT at 
exactly the same time, although if 
you know what pins are used for 
specific sensors or the LED matrix, 
you might be able to work around it 
with a bit of inventive coding. 

The specific sensors on the Sense 
HAT are pretty varied. There’s a 
suite of the usual environmental 
sensors such as temperature, 
pressure and humidity, along 
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=» louse the Sense HAT) you cant Just 


with a trio of positional sensors 
which include an accelerometer, 

a gyroscope, and a magnetometer. 
They’re all pretty accurate and 
able to sense a wide range in their 
respective fields, with the outputs 
instantly modified to be readable 
with the Sense HAT library. 


Put on your coding hat 
To use the Sense HAT, you can’t 
just open up a graphical interface 
for it... at least just yet. It would 
actually be quite simple to create 
a general interface or a custom one 
for your needs, because frankly 
the coding side of the Sense HAT 
is very straightforward, making 
use of Python’s basic syntax and 
some simple command structures 
of its own. So you can easily get 
data from the Sense HAT with 
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only a few lines of code, and very 
easily print out data or images to 
the screen. Text output is handled 
by the code, so you don’t need to 
do any ridiculous coding to change 
individual pictures for it to scroll 
across the screen. 

There’s a massive amount of 
control over the input and output 
as well, with the full power of the 
Sense HAT readily available. There 
are plenty of online resources as 
well (through the Astro Pi and 
Raspberry Pi sites) to help you 
learn exactly how to use it. We like 
the smiley-face tutorial example; 
it made us feel happy. 


We sense a winner 

All in all then, this is an excellent 
bit of gear. It’s well put together 
with a huge number of functions 


open up a graphical interface for it 


and it’s very easy to program 

as well, thanks to some great 
software available for the board. 
You can use it on its own or in 
conjunction with other projects 
(we want to attach it to a robot 

in the near future), and if it’s 
good enough for the ISS, it should 
definitely be enough for any crazy 
ideas you may have for it. 


The Sense HAT is easy to use 
and doesn't compromise any 
of its functions to allow that. 
It's a fantastic board for the 


price and really expands the 
amount you can do with the Pi. 


KKkKKK 
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Waker 
Says 


Very 


cost-effective 
multimeter 


with 


gnalogue bar 


Proster 


EXTECH 
EX330 


MULTIMETER 


The EX330 

has all the 
features of the 
Proster VCg9, 
swapping only 
the transistor 
test mode for 
non-contact 
AC voltage 
detection, ina 
more compact 
package. 
Sadly, it’s also 
considerably 
more expensive. 


£47 /S$60 
adafruit.com 
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PROSTER VC99 MULTIMETER 


PROSTER VC99Y 
MULITIME TER 


With everything a hobbyist could ask for, is the VC family 
of multimeters the bargain it appears to be? 


or years there was a 

eulf between affordable 
multimeters for the 
hobbyist and professional-grade 
hardware. Outgrowing a £10 
multimeter from a high-street 
electronics shop typically meant 
jumping to £100 or more for a pro 
device. More recently, though, 
Chinese multimeters have begun 
to give the big boys a serious 

run for their money without 
breaking the bank - devices like 
the Proster VC99. 

Part of the VC family and 
available from its original design 
manufacturer (ODM) under 
different brands, the Proster VC99 
is designed to give the hobbyist a 
wider range of functionality than 
your average pocket multimeter. 
The usual features are, of course, 
present and correct — there’s AC 
voltage sensing up to 1,000V and DC 
up to 700V, current measurement 


up to 20A for a maximum of ten 
seconds, capacitance measurement, 
and resistance measurement 

with visual and audible continuity 
test modes. But the VC99 really 
packs out the extras list: there’s a 
frequency counter mode suitable 
for measuring up to 60MHz with 

a +0.5% accuracy, a temperature 
sensing mode with bundled K-type 
temperature probe, and a current 
gain test (AFE) for PNP and NPN 
transistors through a built-in 
multi-pole socket. For anyone who 
has ever bought a multimeter with 
an hFE mode plug-in adapter, only 
to lose said adapter shortly after 
purchase, that feature alone is 
worth the asking price. 


Paying for quality 
Naturally, there are reasons why 
the Proster VC99 doesn’t cost twice 
the price. Chief among these is its 
accuracy: while the base accuracy 


of +0.5% compares well with even 
expensive multimeters, the +3.5% 
accuracy rating for capacitance 
measurement is decidedly less 
impressive. The screen, while large 
and easy to read in most conditions, 
is not back-lit, and the kickstand 
to the rear of the chassis is only 
capable of holding the multimeter 
at one rather shallow angle. 
Surprisingly, the VC99 doesn’t 
cut every corner. Included with 
the multimeter is a handy zipped 
storage bag, while the anti-shock 
rubber around the outside of the 
chassis includes storage mounts 
for the probes. These are worth 
mentioning, too: compared to 
similarly priced rivals, the probes 
included with the VC99 are of a 
surprisingly high quality. Unless 
you need something specific, like 
probes ending in test hooks, you’re 
unlikely to be looking to upgrade 
any time soon. 
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Essential features 
When setting the VC99 up for 
measurement, it’s easy to forget 
that it’s a budget multimeter. 
The probes sit securely in their 
ports, and the mode dial switches 
with a pleasingly tactile click. 
Buttons are included just below 
the display for various functions, 
including the ability to switch 
between frequency and duty cycle 
measurement - handy for testing Pi 
projects which use software-driven 
pulse-width modulation - and for 
enabling recording of maximum 
and minimum readings. There’s 
also a button to enable relative 
measurements to be taken: when 
measuring resistance, for example, 
this can be used to automatically 
subtract the resistance of the 
test probes themselves from the 
displayed figure. 

What you don’t get for the low 
purchase price is any sign of a 
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calibration certificate. While the 
measurements on our test unit 
proved accurate against calibrated 
hardware, there’s no guarantee 
the next model off the production 
line will be as well-calibrated. 

It’s possible to remove the casing 
from the multimeter and calibrate 
manually by adjusting on-board 
potentiometers, should you have 
access to calibrated hardware 
against which to compare 
measurements, but doing so will 
invalidate any warranty you may 
have had. 


A tough read 

The only other bone of contention 
with the Proster VC99 is the bundled 
manual. Small and confusingly 
written, it provides most of the 
information you could need to get 
the best from the device, but not 

in the most accessible manner. 
Signs of poor translation are also 
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present, including on the face of 
the multimeter where its ability 
to power off automatically after 
15 minutes of inactivity is proudly 
emblazoned as ‘AUTO OFF POWER’. 
These are minor niggles. While not 
every hobbyist will need anything 
more feature-packed than your 
average pocket multimeter, those 
who do will find the VC99 more 
than up to the job. Anyone working 
in an ill-lit environment, though, 
would do well to spend any money 
saved on a lamp to make up for 
the lack of illumination on the 
multimeter’s display. 


While its accuracy is definitely more suited to the 
hobbyist than the professional, the Proster VC99 
multimeter offers a wealth of functionality 
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at a pocket-friendly price. 
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Maker 
says 
A tiny 
wearable 
platform 


board with a 


lot of might 
Adafruit 


KITRONIK 
ELECTRO 
FASHION 
E-TEXTILES 
DELUXE 
KITA 


Reviewed in 
issue 37, the 
Kitronik kit 
offers less 
programmability 
than Adafruit's, 
but can be had 
at a cheaper 
price in the UK. 


£15 / $35 
cpc.farnell.com 


ADAFRUIT GEMMA STARTER PACK 


ADAFRUIT GEMM 
STARTER PACK 


has Adafruit put together the perfect kit? 


ith wearable computing 
proving a burgeoning 
business, it’s no surprise 
to find companies helping makers 
to get started in the field. The 
majority of the resulting kits are 
based around conductive thread 
which can be sewn into fabric to 
link components electrically. It’s 
easy, then, to see the LEDs and 
conductive thread bobbin included 
in Adafruit’s Gemma Starter Pack 
and dismiss it as just another me- 
too product. Doing so, though, 


ignores the titular star of the show: 


the Gemma. 

Designed and built in 
collaboration with the Arduino 
company, the Gemma is a smart 
break-out board for the ultra- 
compact ATtiny85 microcontroller 
from Atmel. A cut-down version of 
the ATmega chips which power the 
full-size Arduino boards, ATtiny 
microcontrollers are a great choice 
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when low power draw and a small 
footprint are more important than 
the number of pins you can access. 
This makes them an obvious choice 
for wearable projects. 

The two biggest hurdles to using 
an ATtiny with conductive thread — 
the need for special programming 
equipment and its package type — 
are solved by the Gemma. The chip 
is placed on a tiny 28mm diameter 
disc which features connectors for 
three programmable I/O pins, a3.3V 
supply and ground, and a voltage 
input. AJST connector allows 
batteries to be easily connected, 
while a USB connector coupled with 
a specially written bootloader means 
the Gemma can be programmed 
from any PC using the standard 
Arduino IDE and the bundled cable. 

The Gemma is the star, but there 
are plenty of other parts to the 
starter kit. A bundle of colourful 
crocodile leads makes it easy to 


As an introduction to programming wearable electronics, 


prototype your design before sewing 
it down with the conductive thread, 
needles for which are also provided. 
There are four of Adafruit’s famous 
programmable RGB NeoPixel LEDs, 
in wearable-friendly Flora guise, 
and a battery holder for the bundled 
CR2032 batteries with integrated 
power switch. 

The thread itself is of great 
quality with a generous 23-metre 
length provided. A thin, two-ply 
formulation made from stainless 
steel, it’s easier to work with than 
the thicker thread used in the rival 
Kitronik Electro Fashion range, 
but comes with a warning that it 
is ill-suited for projects in which 
your components will draw more 
than around 50mA. A three-ply 
alternative is available separately, 
and is good up to 100mA; both are 
provided on pre-wound bobbins 
suitable for any heavy-thread 
sewing machine. 
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The Gemma is the star, but 
there are plenty of other parts 


As with most electronic textile 
starter kits, there’s an undeniable 
focus on LED projects. Once you’ve 
amused yourself adding RGB 
elowing eyes to kids’ toys, though, 
you can begin to experiment 
with the power of the Gemma. 
Although three input-output pins 
feels limited, they offer surprising 
flexibility: two of the three offer 
pulse-width modulation (PWM) 
support for dimming LEDs or driving 
small servos, while one can also be 
used as an analogue input to reada 
variety of optional sensors. These, 
however, must be compatible with 
the 3.3V logic used by the Gemma, 
in contrast to the 5V logic more 
common in the Arduino world. 
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There are some disappointments, 
too, for Arduino fans who were 
hoping that their projects would be 
directly transferable. Aside from the 
limited number of pins, the Gemma 
has no accessible serial port. This 
means it can’t be combined with, 
for example, a serial-connected 
Bluetooth or Wi-Fi adaptor to easily 
make connected clothing. 

To focus on what it can’t do is to 
ignore the kit’s true goal, however. 
Adafruit bills the Gemma kit as 
the perfect way for beginners to 
get started with programmable 
wearable and electronic textile 
projects, and the obvious next step 
from its non-programmable LED- 
based kit. The use of RGB LEDs, 
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which can be cycled through your Above The kit has 
— fail fe5l k everything you need 
choice of millions of colours, keeps to get started 


things interesting and the low cost 
of the kit makes it accessible to those 
with even a passing curiosity in 
electronic textiles projects, as well as 
Arduino users keen to try something 
a little different in their next build. 
The only real negative is the lack of 
printed documentation. While there’s 
a wealth of supporting information, 
tutorials, and projects on Adafruit’s 
website, a small booklet like that 
provided with the rival Kitronik kit 
would have been welcomed and 
helped to make this bundle a truly 
standalone product. 


fast word 


If you have experience with the Arduino platform 
and want to get into wearable electronics, the 


Gemma is the way to go and this kit a perfect way 
to get started. 
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Maker 
says 
The new 

MEDIAPI+ 

gugmented 

case for 

Raspberry 

Pi 2 


SB-Components 


MEDIA PI PLUS 


£39.99 / $60 


MEDIA PI PLUS 


MODMYPI 
MODULAR 
CASE 


The modular 
case can be 
modified to fit 

in better with 
your lounge, 
revealing only 
the ports you 
need to connect 
toaTV. 


£5.99 /S9 
bit.ly/IM4gQTi 
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is it anecessity for a TV-connected Pi, though: 


e all know at least one 
person who just has a 
Raspberry Pi for a media 
centre, running their TV on Kodi or 
even an ancient version of XBMC 
that does the job. One of the things 
that has been lacking from this 
equation for the longest time is a 
suitable case for a Pi hooked up to 
your television — a case that can slip 
in unnoticed under your TV, next to 
a Sky+ box and that Wii you haven’t 
touched in years. 

While the Media Pi Plus isn’t the 
first one, or even the first Media 
Pi product, they’re rare enough to 
highlight and discuss. In the Media 
Pi Plus’s case, it’s are-release to fit 
the form factor of the Raspberry Pi 
B+ and the Pi 2. In aesthetic terms, 
it absolutely looks like something 
you’d put under your TV, specifically 
something like a Freeview box: it’s 
unassuming, black, and with very 
little branding. 
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There is some construction 
required with the case, as a Raspberry 
Pi is not included. Popping the case 
open, you can see exactly how it 
works: it extends out and relocates 
a number of the Raspberry Pi’s 
ports throughout a largely empty 
box. While this may seem slightly 
redundant, it does provide extra 
power to the USB ports, allowing for 
hubs to be connected. You can also 
connect an IR receiver directly to the 
GPIO ports, which works well with 
the media remote included, even if 
you have the ability to turn the Pi off 
but not on again with it. 

It’s really designed to be used 
with Kodi, which is why our version 
came with OpenELEC on a pre- 
formatted SD card, although other 
Kodi versions and offshoots (we’re 
looking at you, OSMC) will work just 
fine. You may need to tweak some 
of the remote settings, but it will be 
fine nonetheless. 


A media centre case and remote for your Raspberry Pi: 


The best thing about the Media 
Pi Plus is that it's very cheap. Even 
if you factor in a Pi 2, it’s just south 
of £70 for the whole thing, which is 
pretty great value for a media centre 
that will reliably serve you 1080p for 
a long time to come. Construction 
is a bit tricky and the case can feel 
a little flimsy, though if you aren't 
planning on flinging it around or 
otherwise treating it roughly, it’s a 
perfectly serviceable way to make 
your Pi media centre just that bit 
easier to use. 


fast word 


The box is a bit bulky in relation 
to the Pi's size, but it does a 
good job of making the small 


Jump needed to get the Pi 
better suited for powering a TV. 
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Maker 
says 
A super 
affordable 
high-quality 
DAC for the 
Raspberry Pi 


Pimoroni 


PIMORONI 
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PIMORONI PHA! DAC 


HIFIBERRY 
DAC+ 
STANDARD 
RCA 


The HiFiBerry 
uses top-quality 
components 
and has RCA 
jacks pre- 
soldered, but 

its size makes it 
less suitable for 
Pi Zero use. 


£23 /$40 
hifiberry.com 
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the pHAT DAC may be just the add-on you need 


he Pi Zero’s minuscule 
dimensions make it well- 
suited to a variety of tasks, 
except for one omission from 

its feature list: analogue audio. 
For anyone trying to embed a Pi 
Zero into an old radio or speaker 
system, that’s a loss too far. 
Fortunately, the clever people at 
Pimoroni have a solution in the 
form of the pHAT DAC. 

Part of the pHAT family - a 
range of Hardware Attached on Top 
(HAT) boards built with the Pi Zero 
form factor in mind - the pHAT 
DAC adds a high-quality digital- 
to-analogue converter (DAC) to 
the board, allowing any Pi Zero to 
output line-level audio, ready for 
external amplification. 

The output of the pHAT DAC 
shouldn’t be confused with that 
of the analogue output of the full- 
size Raspberry Pi family, either: 
the pHAT’s Texas Instruments 
PCM5102A DAC is a cut above, 
offering noise-free 192kHz 24-bit 
line-level audio. 


The pHAT DAC is supplied 
with a 40-pin female header which 
needs to be soldered onto the board 
before it can be connected to the Pi 
Zero, to which you’l need to have 
soldered a 40-pin male header. 
There’s method in Pimoroni’s 
madness here: if you’re building a 
permanent project, you can drop 
the female header and solder the 
pHAT DAC directly to the Pi Zero’s 
pins to create an ultra-thin circuit 
board sandwich. You can also add 
a pair of RCA connectors, available 
separately for £1.50, to complement 
the 3.5mm jack. 

With the soldering out of the way, 
installation isn’t as straightforward 
as it could be. Step-by-step 
instructions are provided, but are 
unsuitable for the latest Raspbian 
release — and while a community 
member has stepped up and 
provided an installation script to 
make things easier, this isn’t yet 
linked from the product page. 

There’s another fly in the 
ointment once installation is 


If you’re disappointed by the Pi Zero’s lack of analogue audio output, 


complete: there’s no easy way 
to switch between the pHAT 
DAC and HDMI outputs. For 
most uses this isn’t a problem, 
but if you were planning to turn 
a Zero into a multi-function 
portable music player, it may 
cause a headache. 

When you’re up and running, 
there’s plenty to like about the 
pHAT, though -— in particular, the 
superb audio quality when paired 


with a good-quality amplifier and 


decent set of speakers. 


fast word 


While the installation 
experience needs work, the 
pHAT DAC certainly fills a hole. 
If you need analogue audio 


from your Pi Zero, it can't be 
beaten — but paying three 
times the cost of the Zero itself 
may sting a little. 
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PI-TOP 


£195 / $300 


KANO 


Similar in terms 
of gamifying 
programming 
education 

and building, 
although it's not 
the all-in-one 
product pi-top is. 
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PI-|OP 


A laptop built from a Raspberry Pi and crafted yourself. 
Is it too limited by the Pi, or is it a great little portable teaching tool? 


t’s really not that old, but 
do you remember the One 
Laptop Per Child (OLPC) 
project? It was a cheap laptop 
with yesteryear’s components, 
created specifically to try to make 
getting computing into the poorest 
of developing nations as easy 

as possible. It was also very green, 
and we don’t mean ecologically 

- although it was also quite 
low-powered, so it technically 

is ‘green’ in that sense. When 

we got the pi-top out of its box, 
that was the first thing that came 
into our minds, but definitely not 
in a bad way! 

The elevator pitch for the pi-top 
is that it’s a crowdfunded laptop 
kit that the user needs to assemble, 
which is powered by an included 
Raspberry Pi. There’s a lot more to 
it, though, and we’ll get into that 
shortly, but already this gives you 
a basic impression of what we’re 
dealing with. 
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Brush away those 
first impressions 
The pi-top has a big educational 
focus built into it. Each pi-top 
user has to create a cloud account 
before logging in, which then syncs 
settings and such to this account. 
It also syncs data from CEED 
Universe, the gamified learning 
software that is custom-made to 
meet the new GCSE curriculum. 
This, on top of the usual Raspberry 
Pi teaching resources, gives it an 
edge in the classroom, as students 
can use whatever pi-top they want 
without having to carry too much in 
the way of data around with them. 
It sounds great in theory. Let’s 
first go back to the box opening, 
though, before we start discussing 
its other merits. The box itself is 
lovely, with the first thing you see 
being the detached laptop screen’s 
bright green back with the pi-top 
logo in it. All the parts are stored in 
layers, carefully packed with a soft 


foam. You’1] have to look carefully 
to find the laser-cut removable 
circuit cover and the selection of 
required screws and cables, but 
they’re all there. 

The instructions, and indeed 
the assembly, are quite simple. 
There are three main parts of 
the laptop chassis, and only two 
pieces of circuit board including 
the Raspberry Pi, so the majority 
of the process is preparing and 
fitting the parts together. While 
the instructions are generally 
good, they don’t distinguish very 
well between the two types of 
screws. Hint: the screws that look 
like motherboard spaces need 
to be affixed to the PCBs; they 
have a thread running down the 
centre of the head. Also, one of 
the connection orientations is 
not completely clear. We found 
ourselves having to take it apart a 
bit so we could construct it properly 
at one point. 
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It looks great and works absolutely 
fine, thanks to the extra oomph 
of the P1 2's processor 


Otherwise, assembly was quite 
quick. We stuck on Netflix and 
after a couple of episodes of BojJack 
Horseman it was ready to boot up, 
so less than an hour and probably 
quicker without giggling every 
minute. Make sure all the ports and 
cables are properly connected and 
you can turn it on for the first time. 

It’s quick and easy to set up 
an account the first time, and 
you get some choices as to what 
software you want to be able to 
quick-launch from the panel. The 
pi-topOS is a custom interface 
built on top of Raspbian Wheezy 
that has a different offering of 
default software, albeit with full 
access to the standard packages 
you can get on Raspbian anyway. 
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The interface is roughly the same 
as normal Raspbian’s, but with the 
panel down at the bottom anda 
bit more of an OS X vibe with some 
of the display characteristics. It 
looks great and works absolutely 
fine, thanks to the extra oomph of 
the Pi 2’s processor; the only issue 
we had was that the Chromium 
browser selected by default is still 
a little too slow. 

The CEED Universe, currently in 
early alpha at the time of writing, 
is quite interesting. Taking the 
resource- gathering and building 
elements from Minecraft, and 
applying them to a top-down 
aesthetic from early nineties PC 
games as a way to teach coding and 
physical computing, is fairly unique. 


Players are asked to perform Python 
coding tasks as part of the game, 
starting off with something akin 

to Hello World. It’s very gamified, 
and the final version could be really 
something if done right. 

The pi-top, then, is a great piece 
of kit. While it’s probably not going 
to replace a normal laptop ina 
similar price range, it’s an excellent 
educational tool. It’s also a portable 
Raspberry Pi with a ten-hour 
lifespan, which is pretty great on its 
own. Hopefully, it will make its way 
into classrooms or into the hands 
of budding young coders. 
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Waker 
days 


Use me 
to play, learn, 


and create! 
Pi-Top 


Makes great use of the Raspberry Pi to create 
a fully functional laptop that you build with 


your own hands - the entire system is a great 
experience for those wanting to learn. 
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Provides 
almost 
instant 
working 


temperatures 


Tenma 


TENMA 60W DIGITAL SOLDERING STATION 


TENMA 60W DIGITA 
SOLDERING STATIO 


Gareth Halfacree sees if degree-accurate temperature 
control has a place in the hobbyist soldering toolkit... 


WELLER 
SP25N 


For small 
soldering 

jobs, a good 
quality fixed- 
temperature 
iron like this 
Weller SP25N 
is a cheaper 
alternative toa 
bulky soldering 
station. 


£20 / S14 
amazon.co.uk 


readboards are all well 
and good for prototyping, 
but there comes a time in 
every electronics hobbyist’s life 
when it’s time to melt some metal 
and start soldering something 
together. Whether it’s fixing 
something that’s broken or 
building something new, soldering 
is an important skill, and one 
which can be made easier or harder 
depending on the tools you choose. 
The Tenma 6oW Digital Soldering 
Station is designed to bridge the 
gap between ultra-cheap fixed- 
temperature irons which are the 
mainstay of hobbyist solders, 
and the high-end, finely tuned 
tools you’d find at a professional 
engineer’s workstation. Selling 
for sub-£50/$70, the feature 
list is nevertheless impressive: 
the hefty base unit provides 
control of the iron temperature 
between a minimum of 150°C and 
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a maximum of 450°C, either by 
flipping between three preset 
temperature levels or by setting 
your own, and it boasts a stability 
of +1°C with 60W of power 
to back it up. 

To get something out of the 
way early on in this review: no, 
you almost certainly don’t need 
a highly accurate, temperature- 
controlled soldering station. It can, 
however, make life easier. If you’ve 
ever tried soldering and found that 
sometimes the solder just doesn’t 
want to flow - in particular when 
making large connections - then 
you’ve experienced the frustration 
of using an underpowered iron 
that couldn’t supply the heat fast 
enough. If you’ve watched an LED 
or other heat-sensitive component 
go up in smoke during soldering, 
then you’ ve experienced the 
flip side: an iron which delivered 
too much heat. 


Temperature-controlled 
A temperature-controlled iron 
solves all that. You can set the 
temperature just right for the 
solder you’re using, and it will be 
tracked and adjusted by the on- 
board controller. If a large joint is 
drawing heat away from the tip too 
quickly, the output is increased; 
if the tip gets too hot, the output is 
decreased. The aim is temperature 
stability of a single degree. It’s a 
powerful feature, and a definite 
step up from cheaper variable- 
temperature irons which don't 
adjust their output automatically. 
As an entry-level example, 
though, you’d expect to see some 
corners cut in Tenma’s build. 
Looking at the base unit, they’re 
not obvious: the unit is solidly 
built and includes a physical 
power switch, while the large 
backlit LCD display at the front 
is clear and easy to see while 
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soldering. A multi-pole connector 
provides power to and feedback 
from the iron, which is a small 
and lightweight unit thanks to 
the bulk of the electronics being 
located in the base unit. The only 
real negative here is that the unit 
is fixed to the power network 

of the country of purchase - 
either 220V or 110V — and its 
power lead is integrated rather 
than removable. 


Saving pennies 

It’s not until you look to the 
bundled stand that you begin to 
see where Tenma has been saving 
its pennies. While the stand itself 
is a Sturdy metal housing, it fails 
to grip the iron adequately, largely 
thanks to the lack of weight in the 
iron and the relatively heavy lead 
which connects it to the base unit. 
It’s functional, but care is needed 
to make sure the iron doesn’t 
drop out. The bundled cleaning 
sponge, meanwhile, is barely 
adequate, and should be replaced 
with something thicker — or an 
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alternative tip-cleaning system — 
as soon as possible. 

These points aside, though, the 
Tenma soldering station is a joy 
to use. Its 6oW output and dual 
heating coils mean the iron’s 
tip — which is easily replaceable 
through a quick twist of a retaining 
nut, with various shapes and 
sizes available — comes up to 
temperature rapidly. Plus, the live 
temperature readout on the base 
unit means there’s no guesswork 
when it comes to seeing whether 
it’s ready for use or not. 

Another feature is Tenma's 
claim to electrostatic discharge 
(ESD) safety. This is the promise 
that — unlike extremely cheap irons 
often found in starter kits and 
from bargain-basement shops -— 
there’s no risk that a blast of static 
electricity will fry any sensitive 
components as you touch the 
metal tip of the iron to one of their 
contacts. It’s a problem unlikely to 
have affected most hobbyists, but 
the reassurance it won’t bother you 
in the future is undeniably nice. 
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The iron itself is lightweight, 
since the electronics are 
located in the base unit 


Digital 
soldering 
Station 
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The cleaning 
sponge isn't great 


The large 
LCD is clear and 
easy to read 


With such a small cost 
premium over a quality fixed- 
temperature iron and a fair 
list of advantages, if you fancy 


treating yourself to an iron 
upgrade, you could do a lot 
worse than the Tenma. 
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days 


All you 


need to start 
transforming 


the world 


ground you 
Bare Conductive 


MAKEY 
MAKEY 


The device that 
brought the 
banana piano to 
the masses, the 
Makey Makey is 
a cheaper way 
to get started 
with conductive 
materials. 


£40 /$50 
makeymakey.com 
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DUCTIVE 


TQUCH BOARD 


STARTER KIT 


With slick presentation, is the Touch Board the conductive 
marvel Bare Conductive has promised: 


he first thing to discuss 
about the Bare Conductive 
Touch Board Starter Kit has 
to be its price. At just a shade below 
£100 in the UK and $150 in the US, 
it’s certainly no impulse buy for 
the maker on a budget. At the same 
time, though, it’s hard to call it bad 
value for money when you see the 
care and attention that has gone 
into its creation. 

The box, a sizeable affair that 
has no hope of slipping through a 
letter box while you’ re out, contains 
an impressive selection of parts. 
The highlight, naturally, is the 
Touch Board itself, which is joined 
by a generous pot of conductive 
paint with a thick brush, a tube of 
the same paint with a fine-tipped 
nozzle for more precise application, 
a self- powered rechargeable 
speaker, USB cables, a microSD card 
reader, and banana clip cables. This 
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is in addition to a rolled-up stencil 
set (about which more later) and an 
impressive, oversize, full-colour 
euidebook covering the kit’s three 
primary projects. 

The guidebook is far from an 
afterthought, but it’s hardly 
required to get started. The 
packaging of the Touch Board 
itself, a box within a box, doubles 
as a quickstart guide and reveals a 
very clever feature: pre-recorded 
instructional messages already 
loaded onto the bundled 128MB 
microSD card. 

The Touch Board, for those 
unfamiliar, is an Arduino- 
compatible device designed to 
make working with conductive 
paint, thread, and even Play-Doh 
as simple as possible. It arrives 
preconfigured to play MP3 files 
from the SD card each time one of 
its 12 electrode inputs is touched. 


This is then used to drive the 
user’s introduction: connect the 
micro-USB cable and the bundled 
speaker or a pair of headphones, 
touch input Eo with your finger, 
and you’1l hear a congratulatory 
message; press E1 and you’|] learn 
about the board’s inputs. This 
process continues through to E11, 
which sends you off to the Bare 
Conductive website to learn more. 

With the Starter Kit, though, 
you have offline support too. The 
aforementioned guidebook does a 
fantastic job of walking you through 
three example projects in a step- 
by-step fashion. With full-colour 
pictures at every step, it’s hard to 
get lost or confused. 

The first suggested project is 
the biggest: learning how to make 
eraphical sensors. This involves 
the rolled-up stencil and overlays, 
which come with handy sticky tabs. 
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The guidebook does a fantastic 
job of walking you through 
three example projects 


Attach the stencil to a wall - or, if 
you’ re not sure about the somewhat 
permanent nature of the paint 
becoming a fixture of your house, 

a large sheet of paper or card - and 
brush on the paint. Decorate with 
the coloured overlays, use the 
thinner paint tube to draw wires 
leading to the Touch Board, copy 
the MP3s to the microSD, and voila: 
an interactive house. 

The remaining two projects are 
variations on a theme. The first 
adds touch-sensitivity to everyday 
objects, such as a pill bottle which 
reminds you of dosages, or a photo 
frame that describes its own scene. 
The final project has you brushing 
the paint onto the floor to create 
an intruder alarm, albeit one 
which only works if said intruder 
is barefoot. 

The three projects detail 
some, but not all, of the Touch 
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Board’s capabilities. A page of 
extended projects at the back of 
the guidebook points you towards 
the website to learn about the 


board’s more advanced capabilities, 


such as reprogramming it to 
operate as anon-contact distance 
sensor or a Makey Makey-style 
musical instrument. 

At this point, the Touch Board is 
likely to have entranced children 
but potentially turned more 
advanced hobbyists off. Towards 
the back of the guide, it’s revealed 
that the Touch Board is more 


powerful than it would first appear: 


it’s a fully functional Arduino, 
compatible with various Shields 
and add-ons to provide everything 
from Bluetooth connectivity 
to motor control. 

A glance at the board itself 
reveals the familiar Arduino 
headers, albeit without pins, 
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with full access to these for more 
advanced creations. This, combined with 
an Atmel ATmega microcontroller, gives 
the board the ability to do anything an 
Arduino can do, including interfacing 
with external hardware, such as motors, 
Servos, sensors, or even the Raspberry 
Pi itself. Combined with the flexibility of 
Bare Conductive’s clever paint, this gives 
the kit considerable legs when the three 
bundled projects are finished. 


fast word 


It's not cheap, but for anyone 
looking to get started with 
conductive paint or touch- 


based projects, this kit is easy 
to recommend and very well 
put together, with considerable 
attention to detail. 
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Waker 
days 


Great for 
experienced 
users and 


novices alike 
Magzor 


MAGZOR MECHATRONICS 
STARTER PACK 


Related 


CAMJAM 
EDUKIT #3 


Also reviewed 
in this issue, 
the CamJam 
kit allows you 
to build a robot 
and then fairly 
simply program 
it to perform 
various tasks. 
Much simpler 
and aimed 
towards a very 
beginner level 
of robotics, 
though. 


£17/$26 
magpi.cc/105UEOh 


A modular robot that can be built to your specification, without 


even having to write any code. Is it too good to be true: 


t a time when Raspberry Pi 
robotics kits are branching 
out in all directions — 
whether they be simple, easy and 
cheap, or more advanced — it’s nice 
to see something that is trying to 
bridge the gap from beginner to 
intermediate level. 

The Magzor system starts witha 
kit of parts that can interact with 
each other in any combination, 
and hook up to the Raspberry 
Pi to create your own robot or 
mechatronic project. 

The kit works by having you 
input what you want to use ona 
web interface, a bit like the blocks 
of a puzzle. The interface then 
creates a custom recipe of how the 
parts should fit together, and even 
offers some basic code to get them 
all working. It’s quite intuitive, 
although we didn’t get one of the 
more universal parts in the starter 
kit we received. This meant that we 
had to figure out what other bits of 
information it would need before 
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giving us a build that was possible 
with our equipment. 

The instructions themselves are 
eood, but we did find ourselves 
slightly confused at times; at one 
point we were looking for a port 
which wasn’t really labelled on the 
PCB in the way the instructions 
described. By the time we had 
finished an initial build, though, 
we had basically figured out the 
language that the instructions were 
trying to use. 

In a large departure from how 
Raspberry Pi-centric devices work, 
the kit is programmed in C++. 

A basic script is generated that 
gets everything activated, which 
you can modify yourself to get it 
to your exact specifications. It’s 
a weird jump in skill level from 
the construction phase to the 
programming phase, though, 
requiring you to manually compile 
your code rather than being able 
to run it live and make changes 
as yOu go. 


While this level of programming 
is a good thing to learn, it does seem 
at slight odds with the nature of 
the quickly iterable and rebuildable 
robot. With the tutorials the way 
they are now, there’s no easy step- 
by-step guide for creating the code 
and moving it to a Pi to then compile 
and run it; a bit more intuition and 
knowledge is required than some 
robotics beginners might possess. 
With some more focus on that side 
of the system, it will be a lot better, 
but for now it’s maybe outside the 
range of the beginner-level folks. 


fast word 


There are some great ideas 
here, but some parts of the 
building and programming are 


a bit obtuse. It’s quite good 
for people doing slightly more 
advanced mechatronics than 
simple robots, though. 
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days 


Create 


your very own 


Raspberry 
Pj-powered 


robot 
CamJam 


PI2G0 


A little more 
pricey. However, 
this is alsoa 
great little 
starter kit that 
can teach you 
about robotics 
with the Pi. 


£55 /$83 
magpi.cc/1SWFHxi 


raspberrypi.org/magpi 


IESIE- 


rf | A N f | A iV) } 
L p AN [ VI Ww A be { Cady) 7 


N 


eS CamJam EduKit #3 - Robotics 


nl pp | i I A | To afl #) i » Ay i > Ca ah FZ m 
EDUKIT #3 - ROBOTICS 


CAMJAM EDUKIT #3 


ROBOTICS 


A low-cost robot kit that can teach you how to put together 


a Raspberry Pi robot, as well as how to program it 


f you cast your mind back 
a few issues, you may 
remember that we dida 
cover feature on how to create a 
£50 Pi-powered robot. The only 
real problem with the robot was 
that there were a lot of different 
components you’d have to buy 
from many different places to 
keep the price down. We didn’t 
quite have the time to put together 
a kit for people to buy; it doesn’t 
look like that matters too much 
any more, however, as the latest 
CamJam Edukit is incredibly close 
to what we would have created. 

A box full of very standard 
robotics components — anda 
custom board — make up the third 
CamJam kit. While it does have 
these standard components, it’s 
not like a Lego or IKEA kit that 
some of these robot kits resemble. 
As they’re components without a 
chassis (although the box it comes 


in will do ina pinch), the CamJam 
EduKit #3 is designed to give you 
more freedom in what you create 
and actually make you think about 
what you’re constructing. 

A breadboard is also supplied 
with the kit. While on its own 
you might just think it’s another 
breadboard and reduces the 
soldering you need to do, it also 
gives you lots of ways to actually 
expand beyond the limits of the 
original robot, with extra sensors, 
components, and suchlike. 
This makes it very good for 
extracurricular learning beyond 
the scope of the original robot. 

The online worksheets for the 
robot are very comprehensive, 
teaching you how to put it together 
and code it. As the release of the 
EduKkit #3 is somewhat tied to Pi 
Wars, there are also tips on how to 
program it for some of the styles 
of challenges that were involved 


in that event. Indeed, we sawa 
few robots powered by this kit 
trundling around at Pi Wars, and 
one of them did extremely well 
on the line-follower course that 
others were failing with. 

It’s a great beginner’s kit then, 
or at least a kit for people wanting 
to take a step further than some of 
the very simple kits. It teaches you 
a bit more about how the Raspberry 
Pi can actually control a robot, and 
gives you room to grow. 


fast word 


A great kit for beginners 
looking to be a bit more hands- 
on with the robots they create. 


There's plenty of excellent 
documentation to get them 
properly started, as well. 
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Says 


Make as 


many Ubuntu 


flavours 
for the Pi 
gs you can 


think of 
Ubuntu Pi 
Flavour Makers 


UBUNTU 
MATE 


When the 
Raspberry 

Pi 2 came out, 
Ubuntu was 
finally able to 
come to the Pi, 
starting with 
aversion of 
Ubuntu MATE. 


FREE 


ubuntu-mate.org 
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FLAVOUR MAKER 


More flavours of Ubuntu for your Raspberry Pi. Does the Pi provide 
enough power for them, though? 


f you’ve been following 
Raspberry Pi long enough, 
you may know that early on 
in its life there was a call for Ubuntu 
to be used as an operating system for 
it. As one of, if not the most popular, 
version of Linux for home users, this 
distro was wanted by many seeking 
something familiar for their new 
tiny computer. It never came to be. 
However, as Ubuntu is based on 
Debian, Raspbian was basically the 
next best thing. 

When the Raspberry Pi 2 came 
out, this changed with the release 
of Ubuntu MATE for the Pi, and this 
opened the door to more ‘versions’ 
of Ubuntu - or, at least, different 
desktop environments running on 
Ubuntu. Ubuntu Pi Flavour Maker is 
one of the results of this. 

At its core, Flavour Maker is a 
series of scripts that allow you to 
build a slightly custom version 
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of Ubuntu for the Raspberry Pi. 

It uses the all-important armhf 
build of Ubuntu that’s optimised 
for the type of chip running on 

the Pi 2, giving you options for 
different software and desktops, 
and even the choice between server 
and desktop versions depending 

on your needs. 

That may sound a little 
complicated for some more novice 
users, but don’t worry — the kind 
folk who make the software have 
created a series of images you can 
install to an SD card, much like any 
Raspberry Pi operating system. 

On tap are two versions of Ubuntu 
Server: one a very minimal install 
for maximum speed, and a regular 
install if you need more software. 
There are also three ‘spins’ that use 
different desktops: LXDE, Xfce, and 
MATE. LXDE and Xfce are common 
lightweight desktop interfaces used 


on low-powered PCs; Raspbian has 
used LXDE, or at least a version of it, 
since it came out. 


Booting up 
How do they actually run, then? 
Much like the normal Ubuntu, 
there are a few setup steps on 
your first boot, although the main 
installation has already occurred 
so it’s a little truncated. Settings 
such as locale and keyboard are 
sorted before booting you into the 
desktop, although this does take a 
few minutes to actually occur. Each 
successive boot is much faster, 
though, albeit nowhere near the 
speed of booting into Raspbian. 
The OS is presented in a very 
different way from Raspbian. 
Whereas much of Raspbian is 
optimised for the Raspberry Pi, 
with a lot of educational tools in 
there as well, the Ubuntu spins 
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C] search 


bretalled Veruian Latest Version 


Description 


0.4, 34dfegH.2 


Free 


Fast, li ghtweight graphical web browser [debug symbols) 


223 WebkKitGTkK« bindings for the Ruby language 


Fast, lightweight graphical web browser 


Get Screenshot Get Changelog Visil Momepsge 


Midori is. a lightweight web browser based on WebKit. 


its Features include: 


* Full integration with GTKs?. 

* Fast rendering with Websit 

* Tabs, windows and prichen management. 
* Flesiiy configurable wed Search. 

* User scripts and user styles support. 


oad ad * Straightforward bookmark management 


* Cunhomirable and extensible interface, 
* Supper for esberdions harither im Cp. 


Custom Filters 


Search Results 


Arc hetecbure 


* Cushom context menu acthors. 


I packages listed, 1406 installed, Obromen. Oboe installfuporade, Oboe remave 


Above A selection of graphical 
package managers makes 
installation much easier 


are more a traditional desktop — 
no programming tools installed 
as Standard, and using normal 
programs as well. 

A novelty compared to Raspbian is 
the addition of a graphical package 
manager. Both Software Centres and 
classic Synaptic are available, giving 
users a way to search for software 
they may want, which Raspbian 
currently doesn’t let you do easily. 
As this is based on Ubuntu armhf, 
the selection isn’t as broad as in the 
full version of Ubuntu, but it’s still 
very good. A lot of major software 
is available, with the only real limit 
being the power and performance of 
the Raspberry Pi 2 running Ubuntu. 

Due to its use of more standard 
software, Ubuntu can lag a bit on the 
Raspberry Pi 2. Firefox is the default 
browser, and while a lightweight 
alternative like Midori is available, 
it’s not always fast and responsive. 
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It feels like how the browser used 
to be on the original Raspberry Pi - 
functional, but a little frustrating to 
use after a while. Video on YouTube 
seems right out as well, if you want 
to watch anything larger than 36op. 

It’s not all slow, though. With the 
right selection of packages and the 
right use case, it can be just fine. 
Ubuntu is a slightly more resource- 
heavy base than Debian as it is, so 
for anything requiring the extra 
power, it was never going to be the 
operating system or distro of choice. 
The Xfce version does run the best 
out of the three, but Raspbian is still 
better in terms of performance. 

As a desktop system, though, it’s 
better. With a few modifications to 
the default apps, it’s perfectly usable 
as one, and looks a bit more the part 
than Raspbian as well. For projects 
and more niche uses, however, it 
looks like Raspbian is still king. 
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Above YouTube is hit-and-miss, 
especially on a more resource- 
heavy browser like Firefox 


It was never going to be as 
quick as Raspbian, but it's a 
fantastic effort that adds some 


more variety to the operating 
systems available for the 
Raspberry Pi. 


The Official Raspberry Pi Projects Book & 185 


/_ 2 ee 


Touch- 
sensitive 
screen gives 
you finger- 


tip control 
SB Components 
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CONTROL CASE 


A simple case for mini-LCD Raspberry Pi screens - 
how does it hold up under proper use? 


ast issue we reviewed 

the SPI-Box from SB 

Components, a custom 
case for the Raspberry Pi 2 (and 
B+) that allows for a motion sensor 
and a Pi Camera Module to poke 
out of the case. With the bundled 


has the Pi snapped very firmly in 
place; possibly a little too firmly, as 
removing it again can be a little bit 
of an undertaking. 

Putting an LCD screen over the 
interstitial layer and then enclosing 
it with the top is very easy — a lot 


is quite neat as well — normally 
those sort of switches are forgotten 
in these cases. Crucially, there’s 
also more than enough room to 

use the full screen. In addition, 

it has mounts to fix to the wall, 
much like the SPI-Box does. As it 


PIBOW software, this means you have of PiminiTFT screens only use the technically only needs power and 
PITFT+ a functional and cheap security first 26 GPIO pins, a legacy from maybe a wireless dongle, it can be 
The updated camera, with plenty of software the original Raspberry Pi design. a great portable Pi or acheap home 
PITFT Pibow bells and whistles to make it The interstitial layer only opens automation controller on the wall 
allows for the ; — ; ; ; 
eiiqnity larger genuinely useful. Using a similar up these pins, meaning there’s — the only thing really hampering 
second version design ethos, SB Components has no confusion. The entire screen that is the depth of the full unit, 

of Adafruit's also created aspecial case forusing is then accessible through the although that’s not the case’s fault. 


PiITFT screen on 
the Pi Model 2 
and B+. 


a 3.2 LCD touchscreen with the 
Pi in a proper enclosure. It’s very 
inexpensive as well. 

The case comes in three parts: 
Ba base that’s near enough identical 
to the SPI-Box’s design, along 
with an interstitial layer to protect 
some of the Pi components from 
the screen, and finally a top part 
that fits snugly over the Pi and 
screen. Like the SPI-Box, the base 
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case, and even the usual array of 
microswitches (like on the Adafruit 
screen) can be accessed via little 
pinprick holes. Think a reset switch 
on an old piece of electronics — just 
try to avoid using something sharp. 
With the case alone, you have an 
excellent addition to a Raspberry 
Pi you’re using with a touch LCD 
screen. It’s sturdy, very easy to 
construct, and microswitch access 


If you like the idea of the screen 
and case but are baulking at the 
idea of buying a screen, assembling 
it, and then making the whole 
setup work on your Raspberry Pi, 
then SB Components also offers 
a bundle kit (magpi.cc/2drz490). 
At only £29.99 (S43) on top of the 
Raspberry Pi, you basically get the 
kit to create a portable Pi for just 
over £50 in total. 
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The bundle comes witha on this size of touchscreen, but it’s 
compatible mini touchscreen that not completely unusable. At the 
works with the Pi and the case, a very least, it leaves it open for you 
power supply, a WiFi dongle, and to create your own custom interface 


a pre-prepared SD card. As it’s the and it can also access the SPI-Box, 
exact Same case, construction is which is a nice little addition. 


The bundle comes witha 
compatible mini-touchscreen 
that works with the P1 


’ 


the same; the real treat, however, Both versions of the LCD case are 
is the SD card. ereat value for money, especially Much of the 
: : : ; : Pi is accessible 

In the past, preparing Raspbian as they fill a slightly niche market withdheecicen 

to work with these touchscreens for people using or wanting to use off, although it 
not ick process. It’s slightly — thi : : of in It’se : to cbaoehie dM ete hartge apa 

Me d QUICK PIOCESS. Bt y S a - a asy box that is as good as any the first 26 pins 
easier now, thanks to more readily modify the microswitch holes to of the GPIO 


other for using one of the small 
touchscreen displays, opening 


available images. Even so, it’s nice be slightly more usable as well, so 


to have one that just works out you can improve it with the right up a world of possibilities for 
of the box. It still runs modern know-how. Whether you want other projects and uses. 
Raspbian, which includes the the beginnings of a portable Pi or 

interface update from just over a a touchscreen remote, you can’t w ¥ ¥ 4 
year ago. It’s a little tricky to use eo far wrong with this. 
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RASPBERRY PI 
BESTSELLERS 


McGraw Hill's little maker-oriented 
offshoot has turned out several popular 
titles for hobbyists... 


PROGRAMMING 
THE RASPBERRY PI 


Author: Simon Monk 
Publisher: Tab Electronics 
Price: £9.99 

ISBN: 978-0071807838 
magpi.cc/2dXcZlC 


A brilliant Python introduction 
which plays to the Pi's 
strengths. Buy this one now 
(but read the online errata), 
then pass on to a friend when 
you buy the updated edition 
in November. 


PRACTICAL 
ELECTRONICS 
FOR INVENTORS 


Authors: Paul Scherz 

& Simon Monk 

Publisher: Tab Electronics 
Price: £24.99 

ISBN: 978-0071771337 
magpi.cc/2dXbXg90 


How to use and understand 
electronic components, with 
updated chapters on sensors, 
microcontrollers, modular 
electronics, and the latest 
software tools. Worth the price 
for the theory chapter alone. 


RASPBERRY Pl 
PROJECTS FOR 
THE EVIL GENIUS 


Authors: Donald Norris 
Publisher: Tab Electronics 
Price: £15.99 

ISBN: 978-0071821582 
bit.ly/1GBAHJx 


Quirkily written beginner's 
introduction to building hardware 
projects with the Pi (based on 

the older B model, but little 
change needed on most projects 
for current models), from a 
Bluetooth-controlled robot 

to a weather station. 
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TEACH YOUR 
KIDS TO CODE 


Author: Bryson Payne 
Publisher: No Starch 
Price: £19.99 

ISBN: 978-1593276140 
nostarch.com/teachkids 


Dr Payne promises 
“programming so 
easy a parent can do it!”’ Starting 
with turtle graphics, the reader 
is drawn in, and Python seems 
natural, easy, yet still a thing of 
wonder. Learners are encouraged 
to experiment, rather than 
overloaded with details of how 
and why - but where details are 
necessary, such as number types 
and operators, they are introduced. 
As concepts are introduced, we 
feed them into turtle graphics - so 
conditionals lead to fractal spirals, 
and user input selects the shape 
drawn. Programming challenges at 
the end of each chapter - turning 


JAVASCRIPT 
ROBOTICS 


Author: Edited by Rick Waldron | | 
Publisher: Maker Media 
Price: £19.99 

ISBN: 978-1457186950 
oreil.ly/1Gv23Rv 


|» 


tied rae 


The Raspberry Pi is 
a great little board, 
but it doesn’t move around very 
much - unless you put it inside a 
robot, of course. The Johnny-Five 
robotic library offers the chance to 
easily program robots on various 
platforms with JavaScript - in this 
book’s case, “robots that rove, 
Swim, type, walk, dance, send alerts, 
make music” and more. 

Of the projects, only the PiDuino5 
Mobile Robot Platform demands 

a Raspberry Pi (combining the 
Arduino’s extensive peripheral 
range with the Pi’s high 
performance software) - in an 
excellent project by Jonathan 


the High Card game into War, or 
adding sound effects to the Pong 
game - Steer further learning. 
Aimed at children aged 
nine and up, there’s enough 
here for everyone - parents 
can take younger children 
through some of the projects, 
and teens shouldn’t feel talked 
down to. Payne has the balance 
right beween giving enough 
in plentiful, fun projects to 
keep interest, and introducing 
programming concepts to build real 
understanding almost by osmosis. 
Python and Pygame installation 
are banished to an appendix, where 
you’ ll also find instructions on 
creating your own modules! And 
once more, delightful illustrations 
by Miran Lipovacéa lift an already 
excellent No Starch book to another 
level. Strongly recommended for 
learners of all ages. 


Score 


Beri that includes useful tips 
for hardware newbies, such as 
connecting to the Pi without 
hooking your robot up 
to anetwork, as well as 
offering challenges to 
build into the project, such 
as computer vision. 

The other chapters all 
feature different boards, 
and vastly different costs. 

Some have ready-made 
parts available and some involve a 
lot of great DIY - particularly the 
chapter on Delta Bots, the kind of 
industrial robot that built your car 
(unless you’ re driving a Morgan). 
This chapter also offers a lot of 
flexibility for dropping in another 
Pi and extending the interface. All 
feature clear colour pictures to help 
construction. Plenty of fun, plenty 
of learning, and a great introduction 
to practical robotics. 


Score 
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MACHINE 
LEARNING 
WITH SPARK 


Author: Nick Pentreath 
Publisher: Packt 


Price: £30.99 

ISBN: 978-1783288519 

bit.ly/1GnnQdE :: OSCE, 
Machine Learning 
with Spark 

With its four 


Hick Pomtreedi, 


cores and 1GB of 
RAM, the Raspberry Pi 2 is just 
the thing for a small cheap cluster 
to run Apache Spark - the cluster 
computing framework that excels 
with machine learning algorithms. 
Enter Pentreath with an example- 
led book on machine learning with 
Apache Spark. 

Clustering framework MapReduce 
has too high an overhead for 
the Pi 2; however, Spark’s easy- 
to-understand API, and design 
optimised for keeping intermediate 
tasks and data in memory - yet still 


DATA SCIENCE 


FROM SCRATCH 
oT ees 


Author: Joel Grus 
Publisher: O'Reilly 
Price: £26.50 

ISBN: 978-1491901427 
oreil. ly/1awOcy7 
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There are some great 
titles that steer you 
through frameworks and libraries to 
build data science projects, but Grus 
takes a different approach to educate 
the data curious: building tools and 
implementing algorithms from 
scratch, to illuminate particular 
points that will enable you to take 
better advantage of the frameworks 
when you finish the book. 

After introducing data science, 
we start with a fast-paced intro or 
refresher in Python programming 
that does the job well, but highlights 
this book’s one flaw - data science 
libraries still depend, for the most 
part, upon Python 2.7, and thus 
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fitting in the Hadoop ecosystem 

- is agreat platform for studying 

and developing machine learning 

algorithms. This work starts with 

setting up on Amazon EC2, but 
there’s plenty of online help for 
getting a Spark cluster running 
on the Pi, then you’re ready for 
the remaining chapters. 

These chapters cover real- 
life use cases for machine 
learning which will take anyone 
with basic or no knowledge 

of the subject a long way, and 

help those with some machine 
learning experience gain a strong 
understanding of using Spark, 
from text mining to dimensionality 
reduction. Examples are nearly all 
in Scala and Python - the latter a 
welcome plus point for the book 
from the Pi user’s perspective. 
Recommended for all aspiring 
data scientists. 


Score 


there’s no Python 3 here. However, 
the Python 2 is very good and 
worth sticking with for the other 
early lessons in maths. 
The chapters on Statistics, 
probability, and linear 
algebra are an excellent 
refresher for those of us who 
are rusty, and form a strong 
basis for what comes next. 
Having covered the maths 
and the programming - “the 
raw materials to do data science”, 
as Grus puts it - the author turns 
to both the science and the art of 
working with data, showing how 
to explore what you’ve got before 
getting to modelling and machine 
learning. Grus looks into details 
where necessary, but trusts the 
reader to follow up references 
herself in other cases. In all cases, 
this book should make better 
data scientists. 


Score 


ESSENTIAL READING: 


SECURITY 


Security is not a checkbox, but a continual process. 
These five recent titles should keep you thinking 


The Book of PF 


Author: Peter N.M. Hansteen 
Publisher: No Starch 

Price: £23.50 

ISBN: 978-1593275891 
nostarch.com/pf3 


OpenBSD's stateful packet filter, pf, helps § 
you build flexible and powerful firewalls — 
from traffic shaping to blocking policy. 


Network and System Security _ 


Author: John Vacca 
Publisher: Syngress 
Price: £37.99 

ISBN: 978-0124166899 
magpi.cc/2dXdzQ8 


Useful overview for the challenges 
of organisations’ complex networks — 
from LANs to RFID, via cloud security 
and intrusion detection. 


Penetration Testing 


Author: Georgia Weidman 
Publisher: No Starch 
Price: £33.50 

ISBN: 978-1593275648 
nostarch.com/pentesting 


Penetration 
Testing 


; 


Great introduction to finding vulnerabilities 
in your system - penetration testing made 
accessible, and well illustrated too. 


Blockchain: Blueprint 
for aq New Economy 
Author: Melanie Swan 
Publisher: O'Reilly 

Price: £16.50 


ISBN: 978-1491920497 
oreil.ly/1L2AFMq 


Blockchain is more than just bitcoin, 
and information security and digital 
liberties will become more dependent 
upon this technology. 


Bruce Schneier on Trust Set 


Author: Bruce Schneier 
Publisher: Wiley 

Price: £26.99 

ISBN: 978-1118906835 
oreil.ly/1JfnR7G 


Bargain pairing of Liars & 
Outliers (how trust works —- 
and fails - and what we need 
to rethink) and Carry On (155 
“thought-provoking” essays). 
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RASPBERRY PI 
BESTSELLERS 


Apress has several practical books for Pi 
users. Here’s our pick from the most popular 


LEARN RASPBERRY Pl 
PROGRAMMING 
WITH PYTHON 


Author: Wolfram Donat 
Publisher: Apress 
Price: £17.50 

ISBN: 978-1430264248 
bit.ly/1LeM9QN6 


Project-based Python intro 

for the Pi: make a web spider, 

a weather station, a media 
server, ahome security system, 
an underwater photography 
system, and a near-space 
weather balloon with a camera. 


RASPBERRY 
P! HARDWARE 
REFERENCE 


Authors: Warren Gay 
Publisher: Apress 
Price: £11.50 

ISBN: 978-1484208007 
bit.ly/aKWUipn 


Delve deep into the Pi's 
workings for your sensor 
project: power, memory, USB, 
Ethernet, SD cards, I?C, GPIO, 
and the UART (serial) interface. 
With test code in C. 


BEGINNING SENSOR NETWORKS 
WITH ARDUINO AND 
RASPBERRY Pl 


Authors: Charles Bell 
Publisher: Apress 
Price: £23.50 

ISBN: 978-1430258247 
bit.ly/1uu1HaB 


Build a Raspberry Pi-based 
sensor node, then connect 
Arduino sensor nodes and 
XBee radio modules to the Pi, 
and collect data on a Pi-hosted 
MySQL database server. 
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RASPBERRY PI 
FOR KIDS 


Author: Richard Wentk 
Publisher: Wiley 

Price: £21.99 

ISBN: 978-111904951-7 
bit.ly/1K7C41E 


Raspberry Pi 


A well-paced 
introduction that 
eoes from setting up 
to programming and debugging, 
embracing command line skills 
along the way. Fun software 
projects - like Turtles and Minecraft 
(controlling both with Python), 
simple and dynamic websites, 

and using a webcam - introduce 
many useful computing skills. 
Remembering the intended target 
audience, the inevitable setting- 
up chapters are both necessary 

and well judged, with details on 
cables and other information to 
enable younger makers to get going 
without adult help. 


FUNCTIONAL 
PROGRAMMING 


IN PYTHON pp 


Functional 
Progr amming 
IN Python 


Author: David Mertz 
Publisher: O'Reilly 

Price: Free PDF download 
oreil.ly/1Kclhgo 
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Functional programming 
“worries about what is to 
be computed rather than how 
it is to be computed,” preferring 
the evaluation of expressions over 
statements, and treating functions 
as first-class objects (you can pass 
a function to another function as 
if it were a piece of data). Python, 
despite not being a functional 
programming language, is “a 
multiparadigm language that makes 
functional programming easy to do 
when desired, and easy to mix with 
other programming styles.” 

Right from the first chapter, 
‘(Avoiding) Flow Control’, the 
author (a Python Software 


Ignoring the ‘For Kids’ branding, 
this book would be a valuable start 
for any nervous adult computer user 

keen to gain Pi enlightenment. 

From command line and 

nano, to Python, choosing 

a web server and learning 

programming skills, Wentk 

introduces and teaches using 
Raspbian. He does so in a clear 
style with gentle humour and 
an ability to make each learning 
challenge approachable. 
PHP may be losing its lustre but it 
gives the quickest start in working 
with data, and is subsequently 
used for running shell and Python 
commands. Running webcam. py 
within PHP then leads on to 
debugging web problems, fixing 
Unix file permissions, and testing 
your software — all essential skills 
for growing your knowledge after 
finishing the book. 


Score 


Foundation director and sometime 
philosopher) brings you code that 
is subtly altered from imperative 
samples, with changes that 
won’t alarm you but 
will work softly on your 
brain, cumulatively 
helping to shift focus 
from the ‘how’ to the 
‘what’. 

“Simply changing the 
form of expression can 
often make a surprisingly 
large difference in how 
we reason about code and how easy 
it is to understand,” says Mertz, 
as he uses list comprehensions, 
generators, and dictionaries and 
sets to abstract the ‘how’ and 
reorder our thinking on data, 
working up to lazy evaluation and 
higher-order functions (those that 
call or generate other functions). 

A good, quick introduction for all 
Pythonistas looking beyond OOP. 


Score 
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THE 
HARDWARE 
STARTUPa 


Author: Renee DiResta, Brady 


business. From prototyping and 
manufacturing, to community 
engagement and legal concerns, 
and every aspect of developing 

and producing a product then 
getting it to customers, is 
considered in appropriate 
depth for those thinking 


Forrest & Ryan Vinyard : . 
Publisher: O'Reilly HARD WARE seriously of turning 
Price: £23.50 STAR TUP a product idea into 

ISBN: 978-1449371036 a business. 
oreil.ly/aLRSDmb Open-source hardware 


The hardware startup 


a very different beast from its 
antecedents, thanks to the very low 
cost of prototyping with boards like 
the Pi and Arduino, anew ecosystem 
for hardware manufacturing, 
including small manufacturing 
runs and 3D-printed parts, and the 
transfer of lean techniques from 
software to hardware businesses. 
In The Hardware Startup, DiResta, 
Forrest and Vinyard provide a 
roadmap for anyone enticed by the 
lower cost of entry to transform 
their side project into a hardware 


RASPBERRY PI 
COMPUTER VISION 
PROGRAMMING 


Author: Ashwin Pajankar 
Publisher: Packt 


Price: £16.99 
ISBN: 978-1784398286 a 
bit.ly/1Pdzlbf Raspberry pj 
Cc 
Vision Pr Comput jit 
Learning ea 
computer vision 


is best tackled with a practical 
approach: using the BSD-licensed 
OpenCV library, which enables 
image and video processing in 
C/C++, Java, and Python. Pajankar 
introduces OpenCV in a specific 
Pi/Python context but assumes no 
previous Raspberry Pi knowledge 
- fortunately, his Pi introduction 
is admirably brief. However, the 
OpenCV installation section is 
strangely lacking in refinement. 
Python knowledge is assumed, but 
only the basics: NumPy is introduced 
early, for the mathematical 
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Renee DiResta, Brac 


1 UY Forres 
company of today 1S and Ryan Virwar 


= me. 


is only touched on briefly, 
and selling your users’ data 
is almost taken for granted, 
but the focus on a narrow, 
Silicon Valley view of what a startup 
is all about is unsurprising, given the 
smaller number of community and 
cooperative ventures in hardware 
than in software. However, the 
Raspberry Pi itself stands as 
a shining example of a social 
enterprise approach to running 
a successful hardware business. 


Score 


functions needed in using OpenCV. 
Practical examples on images 
and webcam, using the Pi Camera 
Module, carry the less mathematical 
reader through. Noise removal 
and edge detection, useful tasks 
for your own Pi camera projects, 
are followed by motion detection 
and barcode reading. More real- 
life computer vision techniques 
are covered; there is a longer 
final chapter on the SimpleCV 
library, a framework to make 
computer vision tasks easier. 
While many OpenCV books are 
now available, others focus on C++, 
Java, and cross-platform Python 
programming. We could be picky 
about the coding style but overall, 
for a Pi user with a little Python 
experience looking to get started 
with OpenCV and learn the basics of 
computer vision, this curate’s egg of 
a book has much to teach. 


Score 


ESSENTIAL READING: 
APPLIED PYTHON 


Not just for teaching & Pi projects, Python’s a 
great language for real-world tasks of all sorts 


Python Data 
Science Essentials 


Author: Alberto Boschetti 
& Luca Massaron 
Publisher: Packt 

Price: £26.99 

ISBN: 978-1785280429 
bit.ly/1bCAZEA 


Python Data Science 
Essentials 


Direct and practical introduction to data 
analysis with Python, with good code 
examples and a problem-solving focus. 


Web Scraping with Python 


Author: Ryan Mitchell 
Publisher: O'Reilly 
Price: £21.50 

ISBN: 978-1491910290 
oreil.ly/14NkXYBu 


Thorough grounding in the basics of web 
scraping, with balanced and concise 
coverage of a topic that continues to grow. 


Mastering Python 
for Finance 


Author: James Ma Weiming 
Publisher: Packt 

Price: £32.99 

ISBN: 978-1784394516 
bit.ly/1f32g4U 


Mastering Python 
for Finance 


Comprehensive collection of financial theory anc 
mathematical models applied to lucrative problems, 
with OOP and FP. Educational and interesting. 


Black Hat Python 

Author: Justin Seitz Black Hat Python 
Publisher: No Starch rics Payranany f 
Price: £23.50 ae 

ISBN: 978-1593275907 re N 


nostarch.com/blackhatpython \ ap y 
Penetration testing and security analysis, - 
writing network sniffers, manipulating 
packets, infecting virtual machines, 

and creating stealthy Trojans in Python. 


Learning Robotics 
Using Python 


Toe 


Ge Tie 
Fm ey 


Author: Lentin Joseph 
Publisher: Packt 
Price: £29.99 

ISBN: 978-1783287536 
bit.ly/1lrlaeZ 


Learning Robotics 
using Python 


“Robotics is an art.” Python, ROS, 
and OpenCV, for building interactive 
autonomous mobile robots from scratch. 
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BESTSELLERS 


For reliable embedded programming on 
your Pi, nothing gets you closer to bare 
metal than the C programming language 


HEAD FIRST C 


Author: David Griffiths 
& Dawn Griffiths 
Publisher: O'Reilly 
Price: £33.50 

ISBN: 978-1449399917 
oreil.ly/1heoaQR 


Approachable intro for coders 
wanting to learn C, with useful 
self-study projects.. Not a 
definitive reference, buta 
friendly start on the path to 
understanding C. 


THE C 
PROGRAMMING 
LANGUAGE 


Authors: Brian W Kernighan 
& Dennis Ritchie 

Publisher: Prentice Hall 
Price: £41.99 

ISBN: 978-0131103627 
bit.ly/1F2D4bq 


K&R, as it’s Known, is a work 

so concise as to almost bea _ 
Zen koan, yet all C is there: be 

it will make you a better 

programmer, and deepen 

your understanding of C. 


a 


C PROGRAMMING: 
A MODERN APPROACH ___—_ 


Authors: K N King g.N.RINS iN 
Publisher: W W Norton C procrA ” 
Price: £52.50 | oe cr 
ISBN: 978-0393979503 | | 
magpi.cc/2dXdPin 


Fast becoming the best- 
loved book for C learners — 
comprehensive, very correct 
in its approach to C standards, 
and repays hard work with 

C enlightenment. 
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NUMPY 
COOKBOOK 


Author: Ivan Idris ee y, 


Publisher: Packt 
Price: £29.99 

ISBN: 978-1784390945 
bit.ly/1aMrED5c 


Python’s libraries 
are a terrific asset, 
and NumPy’s fast precompiled 
functions for numerical routines — 
complemented by SciPy, Matplotlib, 
IPython, and Scikits — provide not 
just MATLAB-like functionality, 

but a scientific software ecosystem 
with applications you may not 

even have considered. Idris 

surveys all of examples you’d 
expect for scientists, engineers, 
programmers, and analysts, as well 
as unexpected uses like audio and 
image processing. 

“We NumPy users live in exciting 
times,” says Idris, referring to new 
and future NumPy developments 
around cloud, concurrency, and 


THE SMART GIRLS 
GUIDE TO PRIVACY 


Author: Violet Blue 
Publisher: No Starch 
Price: £11.99 

ISBN: 978-1-59327-648-5 
magpi.cc/2dXeikt 


The difference in being 
logged onto a siteasa 
female and as a male 
has to be experienced to 
be believed: the author 
recommends getting a throwaway 
account on a Social media site 
just to try it. Women are targets 
online, and privacy is at risk from 
threats including friends with good 
intentions, greedy companies, and 
people from whom we all need to 
take steps to protect ourselves. 
The book comes with privacy 
stickers, to prevent people using 
your device’s camera to record 
you without your knowledge. 

Eight “privacy tips to use right 
now” provide a ready guide to 


NumPy Cookbook 


Second Edition 


violet blue 


online analytical processing (OLAP) 
for multi-dimensional analytical 
(MDA) queries. But sticking with 
the present, NumPy Cookbook 
introduces the powerful [Python 
environment and gets you 
started with NumPy’s basic 
building blocks: arrays and 
universal functions — where it 
gets onto some Fancy Indexing, 
and starts working on WAV files. 
Audio, and images, yes, either 
side of which is more on arrays 
and functions, as well as speeding 
up code. All this is done in a broad 
context of the SciPy ecosystem, 
and speaking to the wider world — 
whether MATLAB and Octave, or 
R and JPype (for JVM languages). 
Profiling, debugging, testing, and 
behaviour-driven development 
follow, making this a useful book for 
anyone looking at writing practical 
Python code that has life beyond 
their own computer. Recommended. 


Score 


tipping the balance hugely in 
your favour, as does taking the 
privacy check-up. That done, 
Blue shows what 
information not to 
share in order to 
stay safe. If you think 
this is paranoia, read 
here about (male) Wired 
journalist Mat Honan, 
whose digital devices 
were wiped and Twitter 
account offensively 
defaced — all from the 
attacker finding Honan’s address 
(a simple whois lookup) and using 
it to get Amazon account data, then 
move on to Apple. 
Blue provides practical steps 
to deal with all the horrors and 
harassment, recover from identity 
theft, and still be able to pursue 
romance online. Sadly, a very 
necessary book. 


Score 
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HOW 
SOFTWARE 
WORKS 


Author: V Anton Spraul 
Publisher: No Starch 
Price: £19.99 

ISBN: 978-1593276669 
magpi.cc/2dXeMH6 


“We live in an age of magic,” writes 
V Anton Spraul in the introduction, 
referencing Arthur C Clarke’s famous 
dictum on advanced technology. After 
all, many of us work with technology 
but lack a real understanding of 
what’s going on inside the computer. 
From security topics, like password 
hashing and encryption, to other 
underpinnings of modern life like 
search, and map routes, this book 
shows what is happening inside 
programs, what the limitations are, 
and what may develop in the future. 
Encryption lies at the heart of so 
many daily tasks, from shopping to 
checking your bank balance. Spraul 


RASPBERRY PI 
ROBOTICS 
PROJECTS 


Author: Richard Grimmett 
Publisher: Packt 


Price: £29.99 A oe 
' iypnee 
ISBN: 978-1-78528-014-6 ns a 
bit.ly/1 U600VD oy Pl Robotice 
Second Edition 
Right from the set- ——— 


up chapter, with 

remote access via SSH and VNC, 
and nmap to locate your Pi on the 
network, Dr Grimmett assumes 

no knowledge, but introduces 
important topics — the second 
chapter, on programming with 
Python, covers some OOP features, 
using Emacs, and briefly examines 
Gand Cr®, 

The first robotics topic is speech, 
with Espeak and PocketSphinx to 
handle input and output — “what 
self-respecting robot wants to carry 
around a keyboard°” — and your brief 
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takes us back to pre-computer 
encryption, with a lucid explanation 


which will help even non-technical 


users understand the 
process. Particularly 
important is Spraul’s 
discussion of potential 
flaws and weaknesses in 
each technology, which 
will put in perspective for 
the reader various news 
stories on security scares. 
The insights into game 
graphics, computer animation, and 
image compression are fascinating. 
Explanations of techniques used in 
search — from quicksort algorithm 
to hashing — and in concurrency 
programming, will help beginner 
programmers on the Pias they gain 
understanding to really support 
the methods they’re learning. 
Map routes is another informative 
chapter, particularly if you’re working 
ona robotics project. 


Score 


acquaintance with C used to edit and 
rebuild the controlling program. 
In the vision chapter, the basics of 
installation and use of OpenCV are 
well explained. For robot mobility, 
the GPIO controls a motor (no 
soldering necessary), driving 
wheels, and voice commands 
control movement. Then, with 
a choice of ready-assembled 
legs, and a little Python to 
interpret voice commands, your 
robot is ready to tackle uneven 
ground, or even stairs. 
Obstacle-avoidance sensors stop 
your robot blundering into walls; 
wireless and GPS find the robot. 
Finally, Robot Operating System 
(ROS) manages system control. 
Then, using model kits that can 
be controlled by the Pi, take your 
robot on or under water, or up 
in the air. Beginner to roboteer 
in just 276 pages! 


Score 


ESSENTIAL READING: 
3D PRINTING 


3D printing is within reach of everyone, by building 
your own, or sharing at a local makerspace 


Make: 3D Printing 


Author: Anna Kaziunas France 
Publisher: Maker 

Price: £13.50 

ISBN: 978-1457182938 
oreil.ly/1KlLiLGq 


Arms you with everything you need to 
know to understand the exciting but 
often confusing world of 3D printing. 


3D Printing Blueprints 


Author: Joe Larson 
Publisher: Packt 
Price: £30.99 

ISBN: 9781849697088 
bit.ly/1lge22Z 


Makerbot-focused, project-based 
guide to preparing designs for 3D 
printing, using the free and open 
-source Blender program. 


3D Printing For Dummies 


Author: Kalani Kirk Hausman 
Publisher: Wiley 

Price: £21.99 

ISBN: 978-1118660751 
bit.ly/1WT7IJD 


Puts 3D printing in context, 
and shows you how to build 
your own RepRap. 


Open-Source Lab 


Author: Joshua M. Pearce 
Publisher: Elsevier 

Price: £33.99 

ISBN: 9780124104624 
bit.ly/1JyYNas 


Academic guide to building a RepRap, 
then 3D-printing a complete laboratory 
of scientific instruments. 


Eventorbot! 


Author: eventorbot 
Publisher: Instructables 
Price: FREE 
bit.ly/1PUixgw 


Fewer materials anda 
stronger structure give a 
cheaper, easier, and very 
stable, well-designed 3D 
printer. 100% open source. 
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Pragmatics’ Seven Weeks series 
compares solutions in hot topics 
for programmers 


SEVEN DATABASES ss 
INSEVEN WEEKS ~~ 


Author: Eric Redmond 


& Jim R Wilson 

Publisher: Pragmatic Bookshelf seven a eeks 
Price: £23.50 ‘ apie 10 gene : 2 
ISBN: 978-1934356920 and be 5 
bit.ly/1eLiCzB 


A practical dip into NoSQL i 
databases: Redis, Neo4J, pte Re Ay 
CouchDB, MongoDB, HBase, —— 
Riak (after PostgreSQL for a 
comparison). The easiest way to 

quickly gain enough experience 

to make hands-on comparisons. 


SEVEN CONCURRENCY 
MODELS IN SEVEN —_— 


WEEKS a = 


Authors: Paul Butcher 


» Models 
Publisher: Pragmatic Bookshelf Seven concur wis 
Price: £25.50 1 nue 
ISBN: 978-1937785659 Wen ES 


bit.ly/1L5FItS 


As multiple cores proliferate 

in the GPU as well as the CPU, 
Butcher tackles the competing ~ 
techniques for parallelism and en 
concurrency. Well written, and 

strongly grounded in Clojure. 


SEVEN WEB 
FRAM EWORKS - ——_——————— 
INSEVENWEEKS ~ Go 


Authors: Jack Moffitt web prameworks 
& Frederic Daoud seven Seven! Weeks 
Publisher: Pragmatic Bookshelf oon a 
Price: £25.50 

ISBN: 978-1937785635 

bit.ly/1VEahMc 


A fascinating and enjoyable 
journey: explore minimalism, 
composition, static typing, 
state machines, declarative 
syntax, and other approaches 
to web programming, using 
Sinatra, CanJS, AngularJS, 
Ring, Webmachine, Yesod, 
and Immutant. 
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GETTING STARTED 
WITH PYTHON & 
RASPBERRY PI 


Author: Dan Nixon 
Publisher: Packt 
Price: £25.99 

ISBN: 978-1783551590 
bit.ly/1KZemHZ 


and Raspberry P 


We get to review 
many good and 
interesting Python tutorials, 
but a book placing Python 
learning within the context of 
programming the Raspberry Pi is 
always going to have an advantage: 
building quickly towards your 
own projects on the Pi is a great 
motivator. Nixon’s book makes 
the link between basic Python 
learning and our favourite small 
board computer, even in the basics 
— such as treatment of numerical 
variables to best fit GPIO values. 
Nixon excuses his use of Python 
2.7: “this has the widest library 
support and is still the default 


PYTHON 3 
OBJECT-ORIENTED 
PROGRAMMING 


Author: Dusty Phillips 
Publisher: Packt 


Price: £31.99 

ISBN: 978-1784398781 

bit.ly/1LinBQP Python 3 ob 
Programmin 
Second Edition 

A decade ago, 


Drenty Pitti 


Python was an 
overlooked scripting 
language and object-oriented 
programming (OOP) was 
introduced via Java (kitchen sink 
attached), Smalltalk (in academia 
at least - and subsequently 
powering Scratch 1.x), or even 

C++ (ouch). Luckily for learners of 
today, Python is widely accepted, 
and as a multi-paradigm language 
with strong OOP leanings it makes 
an ideal introduction to OOP. 
Phillips’s book builds on basic 
Python knowledge you may have 
picked up with simple procedural 
scripts for the Pi, for example, and 


Getting Started With Python 


ject-orienteg 


Python version on many operating 

systems.” We suggest it’s time 

to drop Python 2 for newcomers. 
Nevertheless, the bulk of 


| early chapters are a good 


Python introduction without 
distorting the lessons to be 
overly Pi-focused, giving a 
good grounding in control 
flow and data structures — 

procedural with a hint of 
functional flavour. 

Object orientation is then 
introduced as a concept ina 
chapter also covering threads and 
locks. The peculiar areas of focus 
continue with a look at packaging 
in Python, but then the book turns 
to GPIO and the Camera Module. 
Data parsing and interfaces round 
out a useful introductory book, 
which will give confident learners 
enough immersion in Python to 
move onto their own projects. 


Score 


gives you the full object-oriented 
treatment. Starting, logically, with 
objects and classes, this leads onto 
inheritance; multiple inheritance 
is discussed (take that, Java) 
and then the first case study. 

Each chapter is rounded 

off with a useful case study 

and practically oriented 
exercises, often generating 
further thoughts on the topic 
to be carried to the reader’s 
own work. 

From attribute accessibility 
to design patterns, Phillips gives 
the essence of OOP in the context 
of Python’s way of doing things 
— along the way stretching best 
practice a little, as some places 
aren’t a comfortable fit for regular 
expressions — but he keeps 
pushing the reader to consider 
each bit of knowledge in the 
context of their own code, making 
for avery interactive book. 


Score 
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MAKE: 
THE BEST OF, 
VOLUME 2 


Author: The Editors of Make 
Publisher: Maker Media 
Price: £19.99 

ISBN: 978-1680450323 
oreil.ly/ahpWhbr 


el 


Want to be inspired? 
Pick a project from 
the contents page and 
start reading. We’d recommend 
something from Chapter 6: Music 
and Audio, which includes Cigar 
Box Guitars, a Laser Harp, and 
a Solar Xylophone. Having been 
inspired, you may find the slightly 
macho introductory section on 
building and equipping your 
workshop easier going, and be more 
forgiving of the jargon-laden text. 
Inspiration can be found on 
almost every page, as this isa 
distillation of eight years of Make 
magazine since the first Best Of 
book was published. Projects are 


SCRATCH 
FOR KIDS 


Author: Derek Breen 
Publisher: Wiley 
Price: £21.99 

ISBN: 978-1119014874 
bit.ly/1FSU6Jm 


Delete the cat. That’s 
Breen’s first instruction. Scratch 

is for everyone, not just younger 
children who like cute cats. But 
Breen has written a book that will 
eet young and old quickly coding 
and learning — creating a Flappy Bird 
clone in the first chapter, such is 
the power of Scratch. 

The introduction, very much in 
the spirit of Italo Calvino’s If OnA 
Winter’s Night A Traveller — but with 
stronger overt humour — draws 
you straight in, and you’ ll only 
put the book down long enough 
to switch on your computer and 
open Scratch. The author’s humour 
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Scratch 


erouped by chapters such as Robots 
and Drones, Microcontrollers and 
Microcomputers, and Fun and 

Games. That middle 

one includes many 

interesting Arduino 

projects including sound 
synthesis, as well as 
turning a Pi into a Tor 
proxy for anonymous 
browsing, or an 
FM transmitter. 

Projects range from the 
mundane but useful (audio 
amplifiers, lost screw finder), 
through difficult to classify (a 
Geiger counter), to pure fun 
(amazing light-up shoes). One 
of the most compelling, which 
few can read without feeling the 
urge to build, is The Most Useless 
Machine: flick the switch, and an 
arm reaches out from a door and 
turns the switch back off. That’s all 
it does. Strangely compelling, ehe 


Volume 2 


Score 


and personality bring the tutorials 

to life, but the useful level of 

detail ensures that the lessons 
Stay with the reader 
much longer. 

Split into three 
sections — Designer, 
Animator, Game 
Developer — Scratch for 
Kids is very strong on 

eraphics, with the vector 
and collage chapters 
being a great end to 

the first section. The Animation 
section builds into a great way to 
teach visually oriented children 
how to code. Attention to detail, 
good graphics and great writing 
characterise a game section 

that takes four classic arcade 
games and once more sneaks in 
learning by osmosis. Unreservedly 
recommended for kids of all ages — 
including grown-up ones! 


Score 


ESSENTIAL READING: 
DATA 


Data - big or otherwise - is a growing 
concern for coders in any language 


Clean Data 


Author: Megan Squire 
Publisher: Packt 
Price: £29.99 

ISBN: 978-1785284014 
bit.ly/1FWLLJh 


Practical strategies to quickly and easily 
bridge the gap between the data we 
want and the data we have. 


Python Data Science 
for Dummies 


Author: John Paul Mueller 
& Luca Massaron 
Publisher: Wiley 

Price: £21.99 

ISBN: 978-1118844182 
bit.ly/1VEcYO1 


hon 


Acomprehensive introduction to practical 
data science using Python. Good for Python 
learners without being patronising. 


Learning Haskell Data Analysis 


Author: James Church 
Publisher: Packt 
Price: £22.99 

ISBN: 978-1784394707 


bit.ly/12RtmVxc Learning Haskell 


Data Analysis 


Haskell-based intro to dealing with data 
that doesn't neglect its mathematical 
nature. Practical and educational. 


S58 Cherth 


Derivatives Analytics with Python: 
Data Analysis, Models, Simulation, 
Calibration and Hedging 


Author: Yves Hilpisch ie 
Derivatives 


Publisher: Wiley : 

lytics 
Price: £60.00 a y “HERE 
ISBN: 978-1119037996 | y non 
bit.ly/1HZDGSG 


Growing use in the financial community 
has given us some useful tools 
for data analysis in Python. 


Learning JavaScript Data 
Structures and Algorithms 


Author: Loiane Groner 
Publisher: Packt 
Price: £27.99 

ISBN: 978-1783554874 
bit.ly/1MYzqzd 


Learning JavaScript Data 
Structures and Algorithms 


Beginner-friendly introduction to 
data structures and algorithms, 
using JavaScript. Comprehensive, 
approachable, excellent. 
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RASPBERRY PI 
BESTSELLERS 


Autumn started with more than a dozen 
Pi-relevant titles from Packt. These three 
are flying off the shelves... 


RASPBERRY PI LED 
BLUEPRINTS 


Author: Agus Kurniawan 
Publisher: Packt 

Price: £19.99 

ISBN: 978-1782175759 
magpi.cc/iSNfliZy 


Never underestimate the power 
of switching on a light by code 
to attract children to coding. 
Kurniawan’s book harnesses 
this magic to introduce a range 
of GPIO and I?C programming 
techniques. 


RASPBERRY PI —. 
PROJECTS 


Authors: Gokhan Kurt 
Publisher: Packt 
Price: £22.99 

ISBN: 978-1785887024 
magpi.cc/1SNfQbu 


A short but handy roundup of 
many ways that your Android 
device can be used with a 

Pi 2, from remote desktop and 
sensors, through surveillance 
cameras and media centres, to 
collecting automotive data. 


PYTHON GAME 
PROGRAMMING 
BY EXAMPLE 


Authors: Joseph Howse 
& Alejandro Rodas de Paz 
Publisher: Packt 

Price: £25.99 

ISBN: 978-1785281532 
magpi.cc/1SNfVfd 


Classic games, useful 
libraries, and essential 
algorithms: Rodas and Howse 
build your knowledge through 
well-chosen combinations of 
all three, then add computer 
vision with OpenCV as the 
icing on the cake. 


FLUENT 
PY THON 


Author: Luciano Ramalho 
Publisher: O'Reilly 

Price: £33.50 

ISBN: 978-1491946008 
oreilly/1FAcbtb 


There are now a few 
books to answer 
that ‘where do I go 
next with Python’’ question, but 
Fluent Python makes a persuasive 
case for a place on your bookshelf 
or SSD. Ramalho delivers all of 
the good things about Python that 
you may miss when coming from 
another language, as Python has 
many features that are unique or 
only found in a few languages. All 
this without straying far from the 
core language and standard library. 
From the power of slicing 
operators on lists, through duck 
typing on the Vector Space Model, 
to unlocking some of the powerful 


PYTHON PARALLEL 


PROGRAMMING 
COOKBOOK 


Author: Giancarlo Zaccone 
Publisher: Packt 

Price: £31.99 

ISBN: 978-1785289583 
magpi.cc/1SNgPYZ 


A cookbook but 
also a tutorial, teaching parallel 
programming with the aid of Python 
as much as parallel programming 
with Python. Python 3 is used in all 
but the GPU programming chapter, 
which mostly uses Nvidia’s CUDA 

— not relevant on the Pi — but it also 
covers PyOpencCL. 

The introductory chapter delves 
into Von Neumann architecture and 
shared memory schemes to build a 
picture of the parallel programmer’s 
operating environment, then 


tackles Python’s biggest problem for 
concurrent programmers, the Global 


Interpreter Lock (GIL). Starting with 


the threading package for traditional 


Licainte Ramin 


Python Parallel 
rogramming Cookbook 


but poorly documented features 
in Python, like coroutines, every 
chapter contains something to 
make you a better programmer. 
Some will impress straight 
away, while others make 
subtle improvements to your 
future code. 

Fluent Python is split into six 
sections, books-within-the- 
book. The first gives essential 
insights into the data model, 

the rest can be read in any 

order as desired; it covers topics 
such as collections (sequences, 
mapping, sets), functions as first 
class objects, building classes, 
generators, concurrency, and 
much more. The REPL is used 
throughout for hands-on learning, 
and there are many glimpses into 
the workings of the very welcoming 
Python community. Destined to be 
another O’ Reilly classic. 


Score 


multi-threading, Zaccone goes 
from how to do it to how it works 
in each example, building through 
semaphores, conditions, 
and queues. 
He moves onto process- 

based parallelism, with 

a useful exploration of 

collective communication, 
asynchronous programming, 
including Python 3.2’s 
concurrent.futures module, 
Asyncio to manage events 
and coroutines, task manipulation, 
and the Future class; the Celery 
framework to handle distribution 
across machines, and other useful 
libraries. Occasional idiosyncrasies 
in English usage - not the author’s 
first language - could have been 
tidied up, but technical content is 
spot on and worth the rare need to 
re-read a sentence for clarity. A good 
introduction and useful reference on 
parallel programming. 


Score 


raspberrypi.org/magpi 


ELECTRONICS 
WORKSHOP. 


Author: Stan Gibilisco 
Publisher: Tab Electronics 
Price: £18.99 

ISBN: 978-0071843805 
magpi.cc/1SNgXrF 


Stan Gibilisco has 
been writing on, and 
tinkering with, electronics for a 
long time, so this short reference 
and introduction benefits from 
distilling decades of experience, 
showing a clarity of approach that 
indicates a writer and tinkerer with 
plenty to pass on to newcomers. 
The opening chapter on ‘Setting 
up Shop’ is a pleasingly minimalist 
alternative to the ‘we assume you 
have a giant spare room and lots 
of money’ approach of some other 
maker introductions. 

Although ideal for newcomers 
— and it can be read linearly — 
there’s plenty of useful reference 
and tips worth dipping into for 


LEARN GAME 
PROG RAMMING 
WITH RUBY 


Author: Mark Sobkowicz 
Publisher: Pragmatic 
Price: £15.99 

ISBN: 978-1680500738 


poorn Gane 
“ith Ruby 


From the contents, 
introduction and content of 
Sobkowicz’s otherwise useful 
introduction to 2D game 
programming, you’d think the 
GNU/Linux platform didn’t exist. 
Windows and Mac OS X get a chapter 
each, but Raspbian’s Linux relatives 
don’t even make a footnote in an 
appendix. Fortunately, you can 

find full instructions on installing 
the Gosu library used in the book 

on Raspbian (or Ubuntu, et al) at 
github.com/gosu — we used rbenv 
to install Gosu on Ruby 2.1.2. That 
done, turn to chapter three, because 
Ruby Game Programming still has 
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Oo Life wien Gn 


those who’ve been soldering since 
the NE555 was a hot new chip. 
Remaining chapters are organised 
by topic in the expected 
manner: Resistors, 
Capacitors, Inductors, 
Transformers, Diodes, 
Transistors, ICs and Digital 
Basics, More Components 
and Techniques, followed 
by useful appendices and 
further reading. 
What really makes the 
book stand out, in addition to 
the clear explanations, is the 
experiments at the end of each 
chapter, which combine practical 
use of components and tools with 
demonstrating various bits of 
electronic theory which would be 
quite dry and dusty if taught only 
as theory. For example, in testing 
a JFET, you gain understanding of 
where electrons should and should 
not flow. 


Score 


plenty to offer on the Pi. This isn’t 
a book about Gosu, or even solely 
about Ruby, but about the 
various techniques 
used in programming 
2D games, which 
> encompass a wide 
| range of gameplay 
and perspective. And 
Python’s expressive and 
Slightly less buttoned-up 
cousin Ruby makes a good 
language for introducing them: it’s 
concise and easy to read. 
Introducing sprites, interaction, 
platform gaming and sideways 
scrolling, Sobkowicz is an able 
euide to all the components and has 
written a book suitable for early- 
stage coders of all ages. Niggles 
about leaving Linux users out in 
the cold aside, this is a practical 
and enjoyable introduction 
to game programming. 


Score 


ESSENTIAL READING: 
COMPSCI ESSENTIALS 


Recent academic tomes to boost your brain 
power, with Python for CompSci learning. 


Introduction to Computing —— 
Using Python ie 
Author: Ljubomir Perkovic 
Publisher: Wiley Computing 
Price: £159.99, or £29.16 for e-book Python 
ISBN: 978-1118890943 coment 
magpi.cc/1SNieiu Lubomir Perkay 


Ww. ae * comer 
a 


Welcome update to the breadth- 
first computer science introductory 
textbook, with a strong focus on OOP. 


Discovering Computer 
Science 


Author: Jessen Havill 

Publisher: Chapman and Hall/CRC 
Price: £57.99 

ISBN: 978-1482254143 
magpi.cc/1iSNijTe 


DISCOVERING 
COMPUTER 
SCIENCI 


Computational thinking as “a powerful 
mode of inquiry and a vehicle of discovery, 
in a wide variety of disciplines.” 


Doing Math with Python 


Author: Amit Saha 
Publisher: No Starch 
Price: £19.99 

ISBN: 978-1593276409 
magpi.cc/2dXgete 


DOING MATH 
wre. ee 


Pre-computer science; catch up on 
high-school mathematics, and have fun 
with Python along the way. 


Computational Physics 


Author: Rubin H Landau, — 
Manuel J Paez & Cristian C Bordeianu Computational 
Publisher: Wiley Physics 


Price: £75.00 
ISBN: 978-3527413157 
magpi.cc/1SNiw95 


Pythonic reworking of a classic that's 
essential for any physics student. Useful 
maths and programming for all scientists. 


Making Music with Computers 


Author: Andrew R Brown 

& Bill Manaris 

Publisher: Chapman and Hall/CRC 
Price: £31.99 

ISBN: 978-1439867914 
magpi.cc/1SNizl7 


Making Music ‘ 
with Computers 


Computer science introduction for a non- 
traditional audience, using music creation 
with Python in a Jython environment. 
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17 years after the source was opened, it’s 
time you embraced the robust, functional 
language which shines at concurrency 


LEARN YOU SOME 
ERLANG FOR ) 
GREAT GOOD! 


Author: Fred Hebert 
Publisher: No Starch 
Price: £33.50 

ISBN: 978-1593274351 
magpi.cc/1NuXisx 


Accessible introduction full 
of real-world examples, with 
an honest look at the good 
and not so good of using 
Erlang. Comprehensive, 

and a good introduction to 
functional programming. 


PROGRAMMING = 


ERLANG =a 


Authors: Joe Armstrong 
Publisher: Pragmatic 
Price: £27.99 

ISBN: 978-1937785536 
magpi.cc/1NuxXoAm 


From one of Erlang’s creators, 
containing real insights 

into the thought process of 
programming in Erlang. The , 
2nd edition contains much ip 
for beginners, but finishes 

with an open-ended problem, 
‘Sherlock's Last Case’. 


PROGRAMMING ~ | 
ELIXIR : 7 


Authors: Dave Thomas 


Publisher: Pragmatic 
Price: £23.99 na 7 
ISBN: 978-1937785581 oe Og CC : 
magpi.cc/1NuXzM4 ‘ | } 5 
Elixir runs on the Erlang VM, pave mom f : 
and the underlying Erlang/ pos A 
OTP architecture, but with an ee i 
extendable, Ruby-like syntax ~~ — aa 


that's quick and powerful in er . 
use. Full review in MagPi #33. 
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CLOJURE 
FOR THE BRAVE 
AND TRUE 


Author: Daniel Higginbotham CLOJ U - j , f 


Publisher: No Starch FOR THE 


Price: £23.50 
ISBN: 978-1593275914 AND 
magpi.cc/1NuXHeC 


learn the wltimate 
language and 


Books with humour 
can be hit-or- 
miss affairs, but 
Higginbotham’s introduction 
to the powerful JVM Lisp is such a 
good language tutorial that even 
those who usually prefer a drier 
approach will be bowled along. 
Early on, readers are introduced 
to Emacs as REPL and editor: 
downloading the book’s Emacs 
configuration package will actually 
give you one of the best starts 
in using Emacs; you’1l soon be 
appreciating Emacs features like 
the kill ring, and discovering why 
it remains a top choice for editing 
and interacting with Lisp family 


GIT FOR 
TEAMS 


Author: Emma Jane Hogbin Westby 
Publisher: O'Reilly 

Price: £33.50 

ISBN: 978-1491911181 
magpi.cc/224fsew 


“You can do more with Git 
than just build software,” 
says Hogbin Westby of this people- 
first approach to version control. 
Git for Teams combines a practical 
look at best practices in Git usage 
with a look at the ‘why’ of Git - 
where it fits into workflow, and 
even how to build the right team 
for a project — and concludes with 
a useful section on Git hosting. 

The chapter ‘Workflows that 
work’ covers the neglected 
essentials of documenting your 
process — something often left 
until after your project has got 
into a confusing mess. The 
practical chapters start with 


TRUE SS 


._ Emm sane Hogan Wiestiry 


languages after 40 years. After 
setting up your tools comes a crash 
course in Clojure fundamentals, with 
aaa with how you would do 

similar things in languages 

like Ruby along the way, to 

highlight key differences 

such as immutable data. 

“Clojure is so elegant that 

it’s difficult to tell anyone 
anything about it without 
somehow improving them,” 
writes Alan Dipert in the 
introduction. Improvement 
here involves fun examples — 
particularly if your idea of fun is 
violence towards hobbits — that 
can make the learning less onerous 
than some contrived ‘real world’ 
examples. Every topic is introduced 
in the best order for growing real 
understanding of Clojure, ina 
journey that will change the way 
you code. 


Score 


‘Teams of One’, giving an excellent 
introduction to Git use, then the 
‘Rrrrgh!’ chapter — rollbacks, 
reverts, resets, and 
rebasing — shows 
the best way to 
make amendments 
without losing 
code or having a 
negative impact on 
the workflow of team 
members. Reviews 
and bug-fixing get 
a chapter each, and the poorly 
named blame command receives 
a fair examination. 
The section on various Git 
hosting services may help you 
find the right public or private 
repository. This book is a most 
useful single guide for those 
needing the technical and social 
side of managing a project, whether 
in traditional employment, an IoT 
startup, or an open source project. 


Score 
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PROGRAMMING 


THE RASPBERRY PI operators before you know it. Next, 


Author: Simon Monk 
Publisher: Tab Electronics 
Price: £9.89 

ISBN: 978-1259587405 
magpi.cc/224fOlh 


This could be the 
perfect introductory 
programming book —. 
to give to someone who’s just 
got a Raspberry Pi for Christmas. 
With no wasted words, Monk 
introduces the Pi and its operating 
system, then teaches both Python 
and using Python with the Pi, ina 
direct and easily absorbed text that 
harks back to the best beginner 
cuides of the 8-bit era. 

Skip the first two dozen pages 
if you are not new to the Pi, 
and dive into Python with an 
introduction that — through 
well-chosen examples, such as 
a dice rolling simulation — will 
have you learning conditionals, 


FUNDAMENTALS 

OF WEARABLE 
COMPUTERS AND 
AUGMENTED REALITY 


Author: Woodrow Barfield 
Publisher: CRC Press 
Price: £95.00 

ISBN: 978-1482243505 
magpi.cc/224g3wG 


As computers get 
small enough to 
mount on the cover of a magazine, 
and as sensors get better, wearable 
computing — data where you need 
it — is within reach of all. From 
Google Glass to Google Cardboard, 
ubiquitous computing is getting 
nearer and cheaper. Augmented 
reality is used across many 
industries, and children solder 
together wearable computers at 
MakeFests. If you’re a maker or 
programmer involved in an AR 
project, this collection of essays 
will broaden your appreciation 

of the field considerably. Barfield 
presents 25 academic papers, over 
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Programmin 
the Raspberry Pi 


Getting Sta 
with Python 


TECOWD EDITIag 


control flow, and comparison 


Hangman introduces functions, 
as well as strings, lists, 
and dictionaries. OOP 
is touched on witha 

temperature converter, 

then file handling and 
GUI programming (with 
Tkinter) through building 
on the earlier code 
examples. The Pygame 
chapter makes use of many 
of the techniques learned, then 
moves on to refactoring. 

The same concise style is 

used to cover the Pi hardware 

for the rest of the book: GPIO 

pins, breadboard prototyping, 
connecting an Arduino, then 

a range of sample projects 

culminating in a Raspberry Pi 

robot. Unreservedly recommended 
for confident beginners of all ages. 


Score 


700 pages, split over four sections: 
Introduction (with some shorter, 
more philosophical, overviews of 
the topic); The Technology (mostly 
displays and haptics, but also 
tracking); Augmented Reality 
(with some fascinating and 
varied cases); and Wearables. 
The last section particularly 
highlights integration into 
textiles and clothing, as well 
as presenting useful research 
on haptic rendering. 
This is a collection of academic 
papers: extensive references are 
given, and the language is academic, 
though mostly quite approachable. 
The research crosses many 
disciplines, and non-mathematical 
readers will only be given pause by 
a couple of chapters. An expensive 
purchase, but perhaps a worthwhile 
one for the local makerspace library, 
particularly if you have an augmented 
reality project in development. 


Score 
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ESSENTIAL READING: 
NEW YEAR RESOLUTIONS 


Kick start your resolution to learn something 
new, or even boost your IT career! 


Resolution: Invent that Pi add-on! 


Fritzing for Inventors 


Author: Simon Monk 
Publisher: Tab Electronics 
Price: £21.99 

ISBN: 978-0071844635 
magpi.cc/224guXY 


-prTZING FOR INVENTORS 


tae mae Peer Pens we eam fal 


Develop, prototype, test, produce, 
and fund an electronics project. 
Full of useful tips. 


Resolution: Get arty! 


The SparkFun Guide to Processing 


THE SPARKFUN 
Author: Derek Runberg PROCESSING 
Publisher: No Starch i 
Price: £19.99 


ISBN: 978-1593276126 
magpi.cc/224gyHd 


Lovingly produced guide to art and 
code with Processing, which now 
runs on the Raspberry Pi. 


Resolution: Get a new job! 


Cracking the Coding Interview 


Author: Gayle Laakmann McDowell 
Publisher: Career Cup 

Price: £25.36 

ISBN: 978-0984782857 
magpi.cc/224gPd8 


Start the New Year with a confident 
crack at a major coding job interview, 
with McDowell's peerless guide. 


Resolution: Machine learning! 


Python Machine Learning 


Author: Sebastian Raschka 
Publisher: Packt 

Price: £28.99 

ISBN: 978-1783555130 
magpi.cc/224gXJw 


Process, learn from, and draw actionable ~==— 
insights out of the otherwise impenetrable 


walls of big data. 


Resolution: Functional programming! 


Author: Delft University 
Publisher: EdX - Online MOOC 
Price: Free - Online MOOC 
ISBN: N/A 
magpi.cc/224h3Rp 


Get to grips with the what, why, and Yann 


functional programming while seamlessly 
absorbing Haskell, then apply in the real world. 
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SUBSCRIBE TODAY 


& GET A PI ZERO 


Subscribe for six issues or a full year to save 25% and get a free computer! 


_ | _ PEE 
Subscription benefits Pricing OF 
Get it first (before stores) Six issues from £30 
Free delivery to your door 12 issues from $55 


Receive a free computer 
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A free Pi Zero v1.3 (the latest model) 
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THE Official 
RASPBERRY PI 


PROJECTS BOOK 


VOLUME 2 


The Raspberry Pi is the best-selling British computer of all time and is 
known the world over for making incredible things from robots to mirrors 
and even art. It’s also helping to revolutionise computing education. Learn 

all about this world’s favourite credit card-sized computer in this book. 


200 PAGES OF PI 


© Learn how easy it is to use your Raspberry Pi 
© Find out about amazing community creations 
© Follow expert guides to make your first project 


© Read definitive reviews of add-ons and accessories 


MAKE YOUR OWN 


raspberrypi.org/magpi 


